Method and system for accessing a piece of content stored on an external content management system

ABSTRACT

A system for a business process hosted on an application server to request content from an external content management system (CMS) independently of the manner in which the content is stored and a method for doing the same. The system comprises a CMS server for managing a content request from the business process to the external CMS; a CMS driver interface operatively associated with the external CMS for transmitting the content request between the external CMS and the CMS server, the CMS driver interface translating a piece of content corresponding to the content request from the external CMS into a specific object representation; and a CMS manager for managing the content request from the business process to the external CMS and keeping track of content available from the external CMS operatively associated with one of the corresponding CMS driver interface.

FIELD OF THE INVENTION

[0001] The present invention relates to a method and system foraccessing a piece of content stored on an external Content ManagementSystem (CMS) and more particularly to a method and system for a businessprocesses wishing to access and modify content stored on an externalCMS, without requiring the business processes to have prior knowledge ofhow or where the content is stored.

DESCRIPTION OF THE PRIOR ART

[0002] The present invention is directed to ensuring how businessprocesses, typically found in the middle tiers of a multi-tierarchitecture, can access content independent as to how the content isstored so that both the business processes and the content may continueto evolve independent of each other.

[0003] In the context of publishing, content can exist in many formatsin many different locations, both from a geographic point of view aswell as from a computer system point of view. In order to ensure that apublishing system can have access to all existing content and futurecontent it is necessary to create a uniform method of representing andaccessing it.

[0004] Existing methods that attempted to address this problem aregeneral and do not sufficiently encapsulate the idea of content from thepublishing perspective. These methods include SQL and ODBC, but are onlyuseful if content exists in relational databases. These methods alsorequire middle-ware to handle the accessing of the content.

[0005] The challenges in electronic publishing include being able toorganize and provide access to content that may exist within or outsidean organization, as well as unifying the access and work-flow of thecontent for users.

SUMMARY OF THE INVENTION

[0006] An object of the invention is to provide a system that canovercome the problems identified in the prior art.

[0007] In broad terms, the present invention is directed to an interfacedefining the way in which a business process can interface with anexternal Content Management System.

[0008] Stated differently, the invention concerns a universal objectrepresentation of a CMS defining a partnership between hierarchicallyorganized content and the business processes wishing to access andmodify the content, without requiring the business processes to haveprior knowledge of how or where the content is stored.

[0009] The invention further defines a model to manage multiple contentsources each providing access to the abstracted content using the sameinterface.

[0010] According to the present invention, there is provided a methodfor a business process hosted on an application server to requestcontent from at least one external content management systemindependently of the manner in which the content is stored. The methodcomprises the step of making a content request from the business processto one of the at least one external content management system via acontent management system server managing the content request from thebusiness process to one of the at least one external content managementsystem; transmitting the content request between one of the at least oneexternal content management system and the content management systemserver via a content management system driver interface translating apiece of content corresponding to the content request from one of the atleast one external content management system into a specific objectrepresentation, the content management system driver interface beingoperatively associated with the at least one external content managementsystem; managing the content request from the business process to one ofthe at least one external content management system and keeping track ofcontent available from one of said at least one external contentmanagement system operatively associated with the corresponding contentmanagement system driver interface via a content management systemmanager; and relaying the specific object representation of the contentfrom the content management system driver interface to the businessprocess via the content management system server.

[0011] According to the present invention, there is also provided asystem for a business process hosted on an application server to requestcontent from at least one external content management systemindependently of the manner in which the content is stored. The systemcomprises a content management system server for managina a contentrequest from the business process to the external content managementsystem; a content management system driver interface operativelyassociated with the at least one external content management system fortransmitting the content request between one of the at least oneexternal content management system and the content management systemserver, the content management system driver interface translating apiece of content corresponding to the content request from one of the atleast one external content management system into a specific objectrepresentation; and a content management system manager for managing thecontent request from the business process to one of the at least oneexternal content management system and keeping track of contentavailable from one of the at least one external content managementsystem operatively associated with one of the corresponding contentmanagement system driver interface. The content management system serverrelays the specific object representation of the content from thecontent management system driver interface to the business process.

BRIEF DESCRIPTION OF THE DRAWINGS

[0012] The present invention will be better understood after having reada detailed description of preferred embodiments thereof made inreference to the following drawings, in which like numbers refer to likeelements:

[0013]FIG. 1 is a schematic high-level representation of a systemaccording to a preferred embodiment of the present invention.

[0014] FIGS. 2 to 7 are schematic representations of UML class models ofa system according to a preferred embodiment of the invention, showingdifferent packages.

[0015]FIG. 8 is a schematic representation of relationships between thebusiness process and the external CMS in the context of deployment in aweb-server environment, according to a preferred embodiment of thepresent invention.

DESCRIPTION OF A PREFERRED EMBODIMENT OF THE INVENTION

[0016] Referring now to FIG. 1, there is shown a high-levelrepresentation of a system according to a preferred embodiment of thepresent invention For a business process 1 hosted on an applicationserver to request content from one external Content Management System 5(hereinafter referred to as external CMS) independently of the manner inwhich the content is stored, a universal object representation of aContent Management System (hereinafter referred to as CMS) is provided.This universal object representation of the CMS comprises a ContentManagement System Server 2, a Content Management System Manager 3, and aContent Management System Driver Interface 4 (hereinafter referred to asCMS Server, CMS Manager and CMS Driver Interface). The CMS Server, CMSManager and CMS Driver Interface are all implemented according to a setof abstract classes.

[0017] Now turning to FIGS. 2 to 7, a piece of content being managed bythe external CMS can be a news article, a JPEG image, or a group ofother content items that share a common parent. To this extent ahierarchical and recursive model for content is defined.

[0018] In order to abstract the relationship between the businessprocess 1 and content that it may require, an object representation of apiece of content is defined as an Item. Items of content are representedas an instantiation of the Item class 6. The Item class 6 can representany type of content, such as documents, multimedia files, etc. AnItemFactory class 8 for constructing the Items themselves is alsodefined. Content Items can be related to each other via a relationshipso that one Item can be the parent of one or more Items. The Item iscategorized by its type, and can be represented by the ItemType class10. The business process 1 obtains an instance of an ItemFactory andinstructs the ItemFactory to create the instances of the Item itrequires. The Item can then provide access to the content data itself,which is stored in Fields class 12, by instructing the Item's ItemTypeto return a list of the Item's Fields. The business process 1 canmanipulate the Items' Field data itself.

[0019] In this manner, it is possible for the business process 1 in amiddle tier, of a multi-tier software architecture, to be programmedwithout prior knowledge of the external CMS 5. The business process 1only needs to reference the content object model by referring toItemFactory and the Items it creates. The business process 1 onlyspecifies a very generic description of the content It requires in theform of ltemType and Fields. The object model Factory takes care ofactually creating the content object itself.

[0020] When the business process 1 requires access to a piece ofcontent, which may physically exist in the external CMS, the businessprocess 1 makes a request for a required piece of content to theuniversal object representation of the CMS. The CMS Driver Interface 4comprises one or many driver(s) each operatively associated with onecorresponding external CMS 5. The driver actually implements the methodsto access the content on the external CMS 5 by sending specificparameters, such as an URL and a set of credentials (username,passwords, etc.), and forwards the content request to the external CMS5. The CMS Driver Interface 4 is responsible for transmitting thecontent request between the external CMS 5 and the CMS Server 2. The CMSDriver Interface 4 translates a piece of content corresponding to thecontent request from one external CMS 5 into an Item objectrepresentation. The CMS Driver Interface class implements the driverand, as part of its initialization, the driver registers itself with theCMS Manager 3.

[0021] Stated differently, the driver defines a set of methods that mustbe implemented to allow an E-Plafform to communicate with an externalCMS. The E-Platform Business Process Core would only need to communicatewith the driver to function independently of the content that it needsaccess to. Thus, the business process that is implemented, primarily inJava, makes requests to the CMS Manager 3 asking for content of aspecific type.

[0022] The CMS Server 2 manages the content request from the businessprocess 1 to the external CMS 5 using the CMS Driver Interface 4. TheCMS Server 2 also relays the Item object representation of the piece ofcontent from the driver to the business process.

[0023] The CMS Manager 3 manages the content request from the businessprocess to one of the external CMS 5 and keeps track of contentavailable from one of the external CMS 5 operat%vely assciated with thecorresponding driver. To keen track of the content available via aspecific driver, the CMS Manager registers the drivers currentlyrunning. The CMS Manager can also unregister these drivers. Managing thecontent sources is implemented through the CMS Manager class thatdefines methods for adding and connecting to CMS Server's.

[0024] The system preferably has a CMS Security Manager for controllingan access to the functionalities of the driver according to specificparameters. The CMS Security Manager controls access to the driveraccording to the set of credentials.

[0025] Business processes 1 access content items individually or ascollections by making a request to ItemFactory. The ItemFactoryconstructs one or more Items according to the request and returns theItems as individual items or as collections of Items. The businessprocess can then interrogate the Items by invoking the Items methods toextract Field information and other Item properties.

[0026] The business process gains access to an Items fields byinstructing the Item's associated FieldFactory to manufacture the Itemsfields.

[0027] An Item is defined to be unique within an external CMS accordingto the Items Primary-Key.

[0028] Possible packages that can be used for implementing the differentCMS class needed are listed hereinabove as examples and for completecomprehension of the preferred embodiment of the system of the presentinvention:

1 CLASS DOCUMENTATION 1.1 Package COM.CONCEPTIS.CMS 1.1.1 CLASS ACTION

[0029]

[0030] public class Action

[0031] extends java.lang.Object

[0032] An Action is performed on a SecureResource by a Cmsuser and mustbe authorized by the SecurityManager to be performed.

[0033] An Action is simply identified by its name, and this classalready provides a useful set of predefined ActionS. Field Summarystatic Action DELETE Defines an Action that removes data from the CMS.static Action INSERT Defines an Action that creates new data in the CMS.private name java.lang.String the name of this Action static Action READDefines an Action that reads data from the CMS. static Action UPDATEDefines an Action that modifies existing data in the CMS.

[0034] Constructor Summary

[0035] Action(java.lang.String name)

[0036] An Action is performed on a SecureResource by a CmsUser and mustbe authorized by the SecurityManager to be performed. Method Summaryboolean equals(java.lang.Object obj) Returns true if the obj parameterdefines an Action that share the same name as this one; false otherwise.java.lang.String getName( ) Returns the name of this Action. privatevoid setName(java.lang.String name) Sets the name of this Action.

[0037] Methods inherited from Class java.lang.Object

[0038] clone, finalize, getClass, hashCode, notify, notifyAll, toString,wait, wait, wait

[0039] Field Detail

[0040] 1.1.1.1 READ

[0041] public static final Action READ

[0042] Defines an Action that reads data from the CMS.

[0043] 1.1.1.2 INSERT

[0044] public static final Action INSERT

[0045] Defines an Action that creates new data in the CMS.

[0046] 1.1.1.3 UPDATE

[0047] public static final Action UPDATE

[0048] Defines an Action that modifies existing data in the CMS.

[0049] 1.1.1.4 DELETE

[0050] public static final Action DELETE

[0051] Defines an Action that removes data from the CMS.

[0052] 1.1.1.5 name

[0053] private java.lang.String name

[0054] the name of this Action

[0055] Constructor Detail

[0056] 1.1.1.6 Action

[0057] public Action(java.lang.String name)

[0058] An Action is performed on a SecureResource by a CmsUser and mustbe authorized by the SecurityManager to be performed.

[0059] Parameters:

[0060] name—the unique name the identifies this Action

[0061] Method Detail

[0062] 1.1.1.7 getName

[0063] public final java.lang.String getName ( )

[0064] Returns the name of this Action.

[0065] Returns:

[0066] the name of this Action

[0067] 1.1.1.8 setName

[0068] private void setName(java.lang.String name)

[0069] Sets the name of this Action.

[0070] Parameters:

[0071] name—the unique name the identifies this Action

[0072] 1.1.1.9 equals

[0073] public boolean equals(java.lang.Object obj)

[0074] Returns true if the obj parameter defines an Action that sharethe same name as this one; false otherwise.

[0075] Overrides:

[0076] equals in class java.lang.Object

[0077] Parameters:

[0078] obj—the Object to compra for equality with this Action

[0079] Returns:

[0080] true if the obj parameter defines an Action that share the samename as this one; false otherwise.

1.1.2 CLASS CMSEXCEPTION

[0081]

[0082] All Implemented Interfaces:

[0083] java.io.Serializable

[0084] Direct Known Subclasses:

[0085] AuthenticationException, AuthorizationException,ConnectionException, MissingResourceException, ModifiedResourceException

[0086] public class CmsException

[0087] extends java.lang.Exception

[0088] Base class for exceptions thrown by the CMS driver.

[0089] See Also:

[0090] Serialized Form

Constructor Summary

[0091]CmsException ( )

[0092] Creates a new instance of CmsException without detail message.

[0093]CmsException(java.lang.String msg)

[0094] Constructs an instance of CmsException with the specified detailmessage.

[0095]CmsException(java.lang.String msg, java.lang.Throwable cause)

[0096] Constructs an instance of cmsexcention with the specified detailmessage.

[0097]CmsException(java.lang.Throwable cause)

[0098] Creates a new instance Of CmsException without detail message.

[0099] Methods inherited from Class java.lang.Throwable

[0100] fillInStackTrace, getcause, getLocalizedMessage, getMessage,getStackTrace, initCause, printStackTrace, printStackTrace,printStackTrace, setStackTrace, toString

[0101] Methods inherited from Class java.lang.Object

[0102] clone, equals, finalize, getclass, hashCode, notify, notifyAll,wait, wait, wait.

Constructor Detail

[0103] 1.1.2.1 CmsException

[0104] public CmsException ( )

[0105] Creates a new instance of CmsException without detail message.

[0106] 1.1.2.2 CmsException

[0107] public CmsException(java.lang.String msg)

[0108] Constructs an instance of CmsException with the specified detailmessage.

[0109] Parameters:

[0110] msg—the detail message.

[0111] 1.1.2.3 CmsException

[0112] public CmsException(java.lang.Throwable cause)

[0113] Creates a new instance of CmsException without detail message.

[0114] Parameters:

[0115] cause—the root cause of the exception

[0116] 1.1.2.4 CmsException

[0117] public CmsException(java.lang.String msg, java.lang.Throwablecause)

[0118] Constructs an instance of CmsException with the specified detailmessage.

[0119] Parameters:

[0120] msg—the detail message.

[0121] cause—the root cause of the exception

1.1.3 CLASS CONNECTIONEXCEPTION

[0122]

[0123] All Implemented Interfaces:

[0124] java.io.Serializable

[0125] public class ConnectionException

[0126] extends CmsException

[0127] Indicates that there is a problem connecting the driver to theactual CMS.

[0128] See Also:

[0129] Serialized Form

Constructor Summary

[0130]ConnectionException( )

[0131] Creates a new instance of ConnectionException without detailmessage.

[0132]ConnectionException(java.lang.String msg)

[0133] Constructs an instance of ConnectionException with the specifieddetail message.

[0134]ConnectionException(java.lang.String msg, java.lang.Throwablecause)

[0135] Constructs an instance of ConnectionException with the specifieddetail message.

[0136]ConnectionException(java.lang.Throwable cause)

[0137] Creates a new instance of ConnectionException without detailmessage.

[0138] Methods inherited from Class java.lang.Throwable

[0139] fillInStackTrace, getCause, getLocalizedMessage, getMessage,getStackTrace, initCause, printStackTrace, printStackTrace,printStackTrace, setStackTrace, tostring

[0140] Methods Iinherited from Class java.lang.Object

[0141] clone, equals, finalize, getclass, hashcode, notify, notifyAll,wait, wait, wait

Constructor Detail

[0142] 1.1.3.1 ConnectionException

[0143] public ConnectionException ( )

[0144] Creates a new instance of ConnectionException without detailmessage.

[0145] 1.1.3.2 ConnectionException

[0146] public ConnectionException(java.lang.String msg)

[0147] Constructs an instance of ConnectionException with the specifieddetail message.

[0148] Parameters:

[0149] msg—the detail message.

[0150] 1.1.3.3 ConnectionException

[0151] public ConnectionException(java.lang.Throwable cause)

[0152] Creates a new instance of ConnectionException without detailmessage.

[0153] Parameters:

[0154] cause—the root cause of the exception

[0155] 1.1.3.4 ConnectionException

[0156] public ConnectionException(java.lang.String msg,java.lang.Throwable cause)

[0157] Constructs an instance of ConnectionException with the specifieddetail message.

[0158] Parameters:

[0159] msg—the detail message.

[0160] cause—the root cause of the exception

1.1.4 CLASS DRIVERMANAGER

[0161]

[0162] public class DriverManager

[0163] extends java.lang.Object

[0164] CMS Driver managerment class. This class is capable ofregistering and unregistering drivers, and providing connections to aCMS via the registered drivers.

[0165]DriverS are expected to register themselves with the DriverManagerwhen the class is first loaded by the class loader.

[0166] See Also:

[0167] Driver Field Summary private drivers static java.util.HashSet Theset of registered drivers. private log static org.apache.log4j.LoggerFor logging purposes.

Constructor Summary

[0168]DriverManager( ) Method Summary static voidderegisterDriver(Driver driver) Removes a Driver from the collection ofregistered drivers. static Connection getConnection(java.lang.Stringurl) Attempts to establish a connection to the CMS at the specified URL.static Driver getDriver(java.lang.String url) Provides the driverrequested in the URL. static java.util.Iterator getDrivers( ) Providesthe collection of registered drivers. static void registerDriver(Driverdriver) Registers a driver with the DriverManager.

[0169] Methods inherited from Class java.lang.Object

[0170] clone, equals, finalize, getclass, hashcode, notify, notifyAll,toString, wait, wait, wait

Field Detail

[0171] 1.1.4.1 log

[0172] private static org.apache.log4j.Logger log

[0173] For logging purposes.

[0174] 1.1.4.2 drivers

[0175] private static java.util.HashSet drivers

[0176] The set of registered drivers. This is initialized when the classis first loaded. Note that the drivers contain no state information- andmav he shared bv any number of objects.

Constructor Detail

[0177] 1.1.4.3 DriverManager

[0178] public DriverManager ( )

Method Detail

[0179] 1.1.4.4 getConnection

[0180] public static Connection getConnection(java.lang.string url)throws CmsException

[0181] Attempts to establish a connection to the CMS at the specifiedURL.

[0182] Parameters:

[0183] url—the url to attempt to connect to

[0184] Returns:

[0185] a connection for the database

[0186] Throws:

[0187]CmsException—if an error occurs

[0188] 1.1.4.5 registerDriver

[0189] public static void registerDriver(Driver driver) throwsCmsException

[0190] Registers a driver with the DriverManager.

[0191] Parameters:

[0192] driver—the driver to register

[0193] Throws:

[0194]CmsException—if an error occurs

[0195] 1.1.4.6 deregisterDriver

[0196] public static void deregisterDriver(Driver driver) throwsCmsException

[0197] Removes a Driver from the collection of registered drivers.

[0198] Parameters:

[0199] driver—the driver to unregister

[0200] Throws:

[0201]CmsException—if an error occurs

[0202] 1.1.4.7 getDrivers

[0203] public static java.util.Iterator getDrivers ( )

[0204] Provides the collection of registered drivers.

[0205] Returns:

[0206] the collection of registered drivers

[0207] 1.1.4.8 getdriver

[0208] public static Driver getDriver(java.lang.String url)

[0209] Provides the driver requested in the URL.

[0210] Parameters:

[0211] url—the url specifying the driver

[0212] Returns:

[0213] an appropriate driver, null if none could be found

1.1.5 CLASS ITEMSEARCHCONSTRAINTS

[0214]

[0215] public class ItemSearchConstraints

[0216] extends java.lang.Object

[0217] Provides constraints on a search for ItemS. Field Summary privateauthors java.util.Set The set of CmsUserS to limit the results by.private collections java.util.Set The set of CollectionS to limit theresults by. private boolean deep Whether the search should be deep(recursively look in item children). private endDate java.util.Date Theend date to constrain the search by. private fields java.util.Set Thefields to search in. private boolean fieldUnion Whether the fields are aunion or not. private freeQuery java.lang.String The free query searchterm. private indices java.util.Map The indices used to limit thesearch. private maxResults java.lang.Integer The maximum number ofresults to return. private int resultsPerPage The number of results perpage, if supported. static int SORT AUTHOR Sort by author. static intSORT FIELD Sort by field. static int SORT ID Sort by Id. static int SORTNAME Sort by name. static int SORT NONE No sorting. static int SORTSCORE Sort by score. static int SORT TYPE Sort by item type. static intSORT UPDATE Sort by update date. private sortFields java.util.Set Thefields to sort by. private int sortOrder Sort method. private Item startThe starting point. private startDate java.util.Date The start date toconstrain the search by. static int TEXT SEARCH EXACT Constant for exacttext searches. static int TEXT SEARCH FUZZY Constant for fuzzy textsearches. static int TEXT SEARCH NORMAL Constant for normal textsearches. private int textSearchType The type of text search to perform.private types java.util.Set The set of ItemTypeS to limit the resultsby. private value java.lang.String The value to search for. privatevalueFields java.util.Collection The collection of value/fields.

Constructor Summary

[0218] ItemSearchConstraints ( ) Method Summary void addAuthor(CmsUseruser) Adds an author id to the search constraints. voidaddCollection(java.util.Collection collection) Adds a collection id tothe search constraints. void addField(Field field) Deprecated. usevalue/fields object and free query value void addIndexValue(Index index,java.lang.String value) Adds an index to constrain the search. voidaddItemType(ItemType type) Adds a item type id to the searchconstraints. void addSortField(Field field) Adds a sort field id to thesearch constraints. void addValueFields(ValueFields constraint) Adds avalue/fields constraint. java.util.Set getAuthors( ) Provides the set ofauthors used to constrain the search. java.util.Set getCollections( )Provides the set of collections used to constrain the search.java.util.Date getEndDate( ) Provides the end date of the searchconstraints. java.util.Set getFields( ) Deprecated. use value/fieldsobject and free query value java.lang.String getFreeQuery( ) Providesthe free query part. java.util.Map getIndices( ) Provides the indexvalues. java.util.Set getItemTypes( ) Provides the set of item typesused to constrain the search. java.lang.Integer getMaximumResults( )Provides the maximum number of results this search is to return. intgetResultsPerPage( ) Provides the number of results per page.java.util.Set getSortFields( ) Provides the set of sort fields used toconstrain the search. int getSortOrder( ) Provides the sort order.java.util.Date getStartDate( ) Provides the start date of the searchconstraints. Item getStartPoint( ) Provides the starting point. intgetTextSearchType( ) Provides the text search type. java.lang.StringgetValue( ) Deprecated. use value/fields object and free query valuejava.util.Collection getValueFields( ) Provides the value/fieldsconstraints. boolean isDeep( ) Indicates whether the search is a deepsearch, that recursively searches through child links. booleanisFieldUnion( ) Deprecated. use value/fields object and free query valuevoid removeAuthor(CmsUser user) Removes an author id from the searchconstraints. void removeCollection(java.util.Collection collection)Removes a collection id from the search constraints. voidremoveField(Field field) Deprecated. use value/fields object and freequery value void removeItemType(ItemType type) Removes a item type idfrom the search constraints. void removeSortField(Field field) Removes asort field id from the search constraints. void setDeep(boolean deep)Sets whether the search is a deep search, that recursively searchesthrough child links. void setEndDate(java.util.Date date) Sets the enddate of the search constraints. void setFieldUnion(boolean fieldUnion)Deprecated. use value/fields object and free query value voidsetFreeQuery(java.lang.String freeQuery) Sets the free query part. voidsetMaximumResults(java.lang.Integer max) Sets the maximum number ofresults this search is to return. void setResultsPerPage(intresultsPerPage) Sets the number of results per page. voidsetSearchType(int type) Sets the text search type. void setSortOrder(intsortOrder) Sets the sort order. void setStartDate(java.util.Date date)Sets the start date of the search constraints. void setStartPoint(Itemstart) Sets the starting point. void setValue(java.lang.String value)Deprecated. use value/fields object and free query valuejava.lang.String toString( ) Provides a string representation of thisobject.

[0219] Methods inherited from Class java.lang.Object

[0220] clone, equals, finalize, getclass, hashCode, notify, notifyAll,wait, wait, wait

Field Detail

[0221] 1.1.5.1 TEXT_SEARCH_EXACT

[0222] public static final int TEXT_SEARCH_EXACT

[0223] Constant for exact text searches.

[0224] See Also:

[0225]Constant Field Values

[0226] 1.1.5.2 TEXT_SEARCH_FUZZY

[0227] public static final int TEXT_SEARCH_FUZZY

[0228] Constant for fuzzy text searches.

[0229] See Also:

[0230]Constant Field Values

[0231] 1.1.5.3 TEXT_SEARCH_NORMAL

[0232] public static final int TEXT_SEARCH_NORMAL

[0233] Constant for normal text searches.

[0234] See Also:

[0235]Constant Field Values

[0236] 1.1.6 SORT_NONE

[0237] public static final int SORT_NONE

[0238] No sorting.

[0239] See Also:

[0240]Constant Field Values

[0241] 1.1.6.1 SORT_AUTHOR

[0242] public static final int SORT_AUTHOR

[0243] Sort by author.

[0244] See Also:

[0245]Constant Field Values

[0246] 1.1.6.2 SORT_UPDATE

[0247] public static final int SORT_UPDATE

[0248] Sort by update date.

[0249] See Also:

[0250]Constant Field Values

[0251] 1.1.6.3 SORT_TYPE

[0252] public static final int SORT_TYPE

[0253] Sort by item type.

[0254] See Also:

[0255]Constant Field Values

[0256] 1.1.6.4 SORT_NAME

[0257] public static final int SORT_NAME

[0258] Sort by name.

[0259] See Also:

[0260]Constant Field Values

[0261] 1.1.6.5 SORT_ID

[0262] public static final int SORT_ID

[0263] Sort by Id.

[0264] See Also:

[0265]Constant Field Values

[0266] 1.1.6.6 SORT_SCORE

[0267] public static final int SORT_SCORE

[0268] Sort by score.

[0269] See Also:

[0270]Constant Field Values

[0271] 1.1.6.7 SORT_FIELD

[0272] public static final int SORT_FIELD

[0273] Sort by field.

[0274] See Also:

[0275]Constant Field Values

[0276] 1.1.6.8 authors

[0277] private java.util.Set authors

[0278] The set of CmsUsers to limit the results by.Null/empty indicatesno limiting.

[0279] 1.1.6.9 collections

[0280] private java.util.Set collections

[0281] The set of Collections to limit the results by. Null/emptyindicates no limiting.

[0282] 1.1.6.10 types

[0283] private java.util.Set types

[0284] The set of ItemTypes to limit the results by. Null/emptyindicates no limiting.

[0285] 1.1.6.11 sortFields

[0286] private java.util.Set sortFields

[0287] The fields to sort by.

[0288] 1.1.6.12 deep

[0289] private boolean deep

[0290] Whether the search should be deep (recursively look in itemchildren).

[0291] 1.1.6.13 startDate

[0292] private java.util.Date startDate

[0293] The start date to constrain the search by. Null/empty indicatesno limiting.

[0294] 1.1.6.14 endDate

[0295] private java.util.Date endDate

[0296] The end date to constrain the search by. Null/empty indicates nolimiting.

[0297] 1.1.6.15 maxResults

[0298] private java.lang.Integer maxResults

[0299] The maximum number of results to return. Null indicates to returnall results.

[0300] 1.1.6.16 textSearchType

[0301] private int textsearchType

[0302] The type of text search to perform. Defaults toTEXT_SEARCH_NORMAL.

[0303] 1.1.6.17 sortOrder

[0304] private int sortOrder

[0305] Sort method.

[0306] 1.1.6.18 resultsPerPage

[0307] private int resultsPerPage

[0308] The number of results per page, if supported.

[0309] 1.1.6.19 start

[0310] private Item start

[0311] The starting point.

[0312] 1.1.6.20 valueFields

[0313] private java.util.Collection valueFields

[0314] The collection of value/fields.

[0315]1.1.6.21 freeQuery

[0316] private java.lang.String freeQuery

[0317] The free query search term.

[0318] 1.1.6.22 indices

[0319] private java.util.Map indices

[0320] The indices used to limit the search. Maps index->values

[0321] 1.1.6.23 value

[0322] private java.lang.String value

[0323] The value to search for.

[0324] 1.1.6.24 fields

[0325] private java.util.Set fields

[0326] The fields to search in. If empty, a full text search will beperformed.

[0327] 1.1.6.25 fieldUnion

[0328] private boolean fieldUnion

[0329] Whether the fields are a union or not.

Constructor Detail

[0330] 1.1.6.26 ItemSearchConstraints

[0331] public ItemSearchConstraints ( )

Method Detail

[0332] 1.1.6.27 addAuthor

[0333] public void addAuthor(CmsUser user)

[0334] Adds an author id to the search constraints. If the author isalready in the contraints, this method does nothing but does notcomplain.

[0335] Parameters:

[0336] user—the author

[0337] 1.1.6.28 removeAuthor

[0338] public void removeAuthor(CmsUser user)

[0339] Removes an author id from the search constraints. If the authoris not in the contraints, this method does nothing but does notcomplain.

[0340] Parameters:

[0341] user—the author

[0342] 1.1.6.29 getAuthors

[0343] public java.util.Set getAuthors ( )

[0344] Provides the set of authors used to constrain the search.

[0345] Returns:

[0346] the set of authors used to constrain the search; may be null

[0347] 1.1.6.30 addCollection

[0348] public void addCollection(java.util.Collection collection)

[0349] Adds a collection id to the search constraints. If the collectionis already in the constraints, this methods does nothing but does notcomplain.

[0350] Parameters:

[0351] collection—the the collection

[0352] 1.1.6.31 removeCollection

[0353] public void removeCollection(java.util.Collection collection)

[0354] Removes a collection id from the search constraints. If thecollection is not in the contraints, this method does nothing but doesnot complain.

[0355] Parameters:

[0356] collection—the collection

[0357] 1.1.6.32 getCollections

[0358] public java.util.Set getCollections ( )

[0359] Provides the set of collections used to constrain the search.

[0360] Returns:

[0361] the set of collection ids used to constrain the search; may benull

[0362] 1.1.6.33 addItemType

[0363] public void addItemType(ItemType type)

[0364] Adds a item type id to the search constraints. If the type isalready in the constraints, this methods does nothing but does notcomplain.

[0365] Parameters:

[0366] type—the item type

[0367] 1.1.6.34 removeItemType

[0368] public void removeItemType(ItemType type)

[0369] Removes a item type id from the search constraints. If the typeis not in the contraints, this method does nothing but does notcomplain.

[0370] Parameters:

[0371] type—the item type

[0372] 1.1.6.35 getItemTypes

[0373] public java.util.Set getItemTypes ( )

[0374] Provides the set of item types used to constrain the search.

[0375] Returns:

[0376] the set of item types used to constrain the search; may be null

[0377] 1.1.6.36 addSortField

[0378] public void addSortField(Field field)

[0379] Adds a sort field id to the search constraints. If the field isalready in the constraints, this methods does nothing but does notcomplain.

[0380] Parameters:

[0381] field—the field

[0382] 1.1.6.37 removeSortField

[0383] public void removeSortField(Field field)

[0384] Removes a sort field id from the search constraints. If the fieldis not in the contraints, this method does nothing but does notcomplain.

[0385] Parameters:

[0386] field—the field

[0387] 1.1.6.38 getSortFields ( )

[0388] public java.util.Set getSortFields ( )

[0389] Provides the set of sort fields used to constrain the search.

[0390] Returns:

[0391] the set of field ids used to constrain the search; may be null

[0392] 1.1.6.39 isDeep

[0393] public boolean isDeep ( )

[0394] Indicates whether the search is a deep search, that recursivelysearches through child links.

[0395] Returns:

[0396] true if the search is deep, false otherwise

[0397] 1.1.6.40 setDeep

[0398] public void setDeep(boolean deep)

[0399] Sets whether the search is a deep search, that recursivelysearches through child links.

[0400] Parameters:

[0401] deep—true if the search is to be deep, false otherwise

[0402] 1.1.6.41 getStartDate

[0403] public java.util.Date getStartDate ( )

[0404] Provides the start date of the search constraints.

[0405] Returns:

[0406] the starting date that is constraining the search

[0407] 1.1.6.42 setStartDate

[0408] public void setStartDate(java.util.Date date)

[0409] Sets the start date of the search constraints.

[0410] Parameters:

[0411] date—the starting date to constrain the search

[0412] 1.1.6.43 getEndDate

[0413] public java.util.Date getEndDate ( )

[0414] Provides the end date of the search constraints.

[0415] Returns:

[0416] the ending date that is constraining the search

[0417] 1.1.6.44 setEndDate

[0418] public void setEndDate(java.util.Date date)

[0419] Sets the end date of the search constraints.

[0420] Parameters:

[0421] date—the ending date to constrain the search

[0422] 1.1.6.45 getMaximumResults

[0423] public java.lang.Integer getMaximumResults ( )

[0424] Provides the maximum number of results this search is to return.Null indicates no limit to the number of results returned.

[0425] Returns:

[0426] the maximum number of search results (null indicates no limit)

[0427] 1.1.6.46 setMaximumResults

[0428] public void setMaximumResults(java.lang.Integer max)

[0429] Sets the maximum number of results this search is to return. Nullindicates no limit to the number of results returned.

[0430] Parameters:

[0431] max—the maximum number of search results (null indicates nolimit)

[0432] 1.1.6.47 getTextSearchType

[0433] public int getTextSearchType ( )

[0434] Provides the text search type. The default text search type is a“normal” search (neither exact not fuzzy).

[0435] Returns:

[0436] the type of text searching being done

[0437] 1.1.6.48 setSearchType

[0438] public void setSearchType(int type)

[0439] Sets the text search type.

[0440] Parameters:

[0441] type—the text search type

[0442] 1.1.6.49 getStartPoint

[0443] public Item getStartPoint ( )

[0444] Provides the starting point.

[0445] Returns:

[0446] the starting point

[0447] 1.1.6.50 setStartPoint

[0448] public void setStartPoint(Item start)

[0449] Sets the starting point.

[0450] Parameters:

[0451] start—the starting point

[0452] 1.1.6.51 getSortOrder

[0453] public int getSortOrder ( )

[0454] Provides the sort order.

[0455] Returns:

[0456] sort order

[0457] 1.1.6.52 setSortOrder

[0458] public void setSortOrder(int sortOrder)

[0459] Sets the sort order.

[0460] Parameters:

[0461] sortOrder—the sort order

[0462] 1.1.6.53 getResultsPerPage

[0463] public int getResultsPerPage ( )

[0464] Provides the number of results per page.

[0465] Returns:

[0466] the number of results per page

[0467] 1.1.6.54 setResultsPerPage

[0468] public void setResultoPerPage(int resultsPerPage)

[0469] Sets the number of results per page.

[0470] Parameters:

[0471] resultsPerPage—the number of results per page

[0472] 1.1.6.55 getFreeQuery

[0473] public java.lang.String getFreeQuery ( )

[0474] Provides the free query part.

[0475] Returns:

[0476] the free query part (can be null)

[0477] 1.1.6.56 setFreeQuery

[0478] public void setFreeQuery(java.lang.String freeQuery)

[0479] Sets the free query part.

[0480] Parameters:

[0481] freeQuery—the free query part (can be null)

[0482] 1.1.6.57 addValueFields

[0483] public void addValueFields(ValueFields constraint)

[0484] Adds a value/fields constraint.

[0485] Parameters:

[0486] constraint—the value/fields constraint

[0487] 1.1.6.58 getValueFields

[0488] public java.util.Collection getValueFields ( )

[0489] Provides the value/fields constraints.

[0490] Returns:

[0491] the value/fields constraints (empty, but never null)

[0492] 1.1.6.59 addField

[0493] public void addField(Field field)

[0494] Deprecated. use value/fields object andfree query value

[0495] Adds a field id to the search constraints. If the field isalready in the constraints, this methods does nothing but does notcomplain.

[0496] Parameters:

[0497] field—the field

[0498] 1.1.6.60 removeField

[0499] public void removeField(Field field)

[0500] Deprecated. use valuefields object andfree query value

[0501] Removes a field id from the search constraints. If the field isnot in the contraints, this method does nothing but does not complain.

[0502] Parameters:

[0503] field—the field

[0504] 1.1.6.61 getFields

[0505] public java.util.Set getFields ( )

[0506] Deprecated. use value/fields object andfree query value

[0507] Provides the set of fields used to constrain the search.

[0508] Returns:

[0509] the set of field ids used to constrain the search; may be null

[0510] 1.1.6.62 getValue

[0511] public java.lang.String getvalue ( )

[0512] Deprecated. use valuefields object andfree query value

[0513] Provides the value to search for.

[0514] Returns:

[0515] the value to search for

[0516] 1.1.6.63 setValue

[0517] public void setvalue(java.lang.String value)

[0518] Deprecated. use value/fields object and free query value

[0519] Sets the value to search for.

[0520] Parameters:

[0521] value—the value to search for

[0522] 1.1.6.64 isFieldUnion

[0523] public boolean isFieldUnion ( )

[0524] Deprecated. use value/fields object and free query value

[0525] Provides the field union.

[0526] Returns:

[0527] true if any matching fields product a result, false if all fieldsmust match for a result

[0528] 1.1.6.65 setFieldUnion

[0529] public void setFieldUnion(boolean fieldUnion)

[0530] Deprecated. use value/fields object and free query value

[0531] Sets the field union.

[0532] Parameters:

[0533] fieldUnion—true if any matching fields product a result, false ifall fields must match for a result

[0534] 1.1.6.66 addIndexValue

[0535] public void addIndexValue(Index index, java.lang.String value)

[0536] Adds an index to constrain the search.

[0537] Parameters:

[0538] index—the index

[0539] value—the value for the index

[0540] 1.1.6.67 getIndices

[0541] public java.util.Map getIndices ( )

[0542] Provides the index values.

[0543] Returns:

[0544] the index constraints

[0545] 1.1.6.68 toString

[0546] public java.lang.String toString ( )

[0547] Provides a string representation of this object.

[0548] Overrides:

[0549] toString in class java.lang.Object

[0550] Returns:

[0551] a string representation of this object

1.1.7 CLASS MISSINGRESOURCEEXCEPTION

[0552]

[0553] All Implemented Interfaces:

[0554] java.io.Serializable

[0555] public class MissingResourceException

[0556] extends CmsException

[0557] Indicates thiat an attempt was made to access a non-existantresource.

[0558] See Also:

[0559] Serialized Form

Constructor Summary

[0560] MissingResourcException ( )

[0561] Creates a new instance Of MissingResourceException without detailmessage.

[0562] MissingResourceException(java. lang. String msg)

[0563] Constructs an instance of MissingResourceException with thespecified detail message.

[0564] MissingResourceException (java.lang.String rnsg,java.lang.Throwable cause)

[0565] Constructs an instance of MissingResourceException with thespecified detail message.

[0566] MissingResourceException (java.lang.Throwable cause)

[0567] Creates a new instance Of MissingResourceException without detailmessage.

[0568] Methods inherited -from classia va.lang.Throwable

[0569] fillInStackTrace, getcause, getLocalizedMessage, getMessage,getStackTrace, initcause, printStackTrace, printStackTrace,printStackTrace, setStackTrace, tostring

[0570] Methods inherited from class java.lang.Object

[0571] clone, equals, finalize, getclass, hashCode, notify, notifyAll,wait, wait, wait

Constructor Detail

[0572] 1.1.7.1 MissingResourceException

[0573] public MissingResourceException ( )

[0574] Creates a new instance Of MissingResourceException without detailmessage.

[0575] 1.1.7.2 MissingResourceException

[0576] public MissingResourceException (java.lang.String msg)

[0577] Constructs an instance of MissingResourceException with thespecified detail message.

[0578] Parameters:

[0579] msg—the detail message.

[0580] 1.1.7.3 MissingResourceException

[0581] public MissingResourceException(java.lang.Throwable cause)

[0582] Creates a new instance of MissingResourceException without detailmessage.

[0583] Parameters:

[0584] cause—the root cause of the exception

[0585] 1.1.7.4 MissingResourceException

[0586] public MissingResourceException(java.lang.String msg,java.lang.Throwable cause)

[0587] Constructs an instance of MissingResourceException with thespecified detail message.

[0588] Parameters:

[0589] msg—the detail message.

[0590] cause—the root cause of the exception

1.1.8 CLASS MISSINGRESOURCEEXCEPTION

[0591]

[0592] All Implemented Interfaces:

[0593] java.io.Serializable

[0594] public class MissingResourceException

[0595] extends CmsException

[0596] Indicates that an attempt was made to access a non-existantresource.

[0597] See Also:

[0598] Serialized Form

Constructor Summary

[0599] MissingResourceException ( )

[0600] Creates a new instance of MissingResourceException without detailmessage.

[0601] MissingResourceException(java.lang.String msg)

[0602] Constructs an instance of MissingResourceException with thespecified detail message.

[0603] MissingResourceException(java.lang.String msg,java.lang.Throwable cause)

[0604] Constructs an instance of MissingResourceException with thespecified detail message.

[0605] MissingResourceException(java.lang.Throwable cause)

[0606] Creates a new instance of MissingResourceException without detailmessage.

[0607] Methods inherited from Class java.lang.Throwable

[0608] fillInStackTrace, getcause, getLocalizedMessage, getMessage,getstackTrace, initCause, printStackTrace, printStackTrace,printStackTrace, setStackTrace, toString

[0609] Methods inherited from Class java.lang.Object

[0610] clone, equals, finalize, getclass, hashCode, notify, notifyAll,wait, wait, wait

Constructor Detail

[0611] 1.1.8.1 MissingResourceException

[0612] public MissingResourceException ( )

[0613] Creates a new instance of MissingResourceException without detailmessage.

[0614] 1.1.8.2 MissingResourceException

[0615] public MissingResourceException(java.lang.String msg)

[0616] Constructs an instance of MissingResourceException with thespecified detail message.

[0617] Parameters:

[0618] msg—the detail message.

[0619] 1.1.8.3 MissingResourceException

[0620] public MissingResourceException(java.lang.Throwable cause)

[0621] Creates a new instance of MissingResourceException without detailmessage.

[0622] Parameters:

[0623] cause—the root cause of the exception

[0624] 1.1.8.4 MissingResourceException

[0625] public MissingResourceException(java.lang.String msg,java.lang.Throwable cause)

[0626] Constructs an instance of MissinqResourceException with thespecified detail message.

[0627] Parameters:

[0628] msg—the detail message.

[0629] cause—the root cause of the exception

1.1.9 CLASS MODIFIEDRESOURCEEXCEPTION

[0630]

[0631] All Implemented Interfaces:

[0632] java.io.Serializable

[0633] public class ModifiedResourceException

[0634] extends CmsException

[0635] Indicates that a resource has been modified since it was lastaccessed.

[0636] See Also:

[0637] Serialized Form

Constructor Summary

[0638] ModifiedResourceException ( )

[0639] Creates a new instance of ModifiedResourceException withoutdetail message.

[0640] ModifiedResourceException(java.lang.String msg)

[0641] Constructs an instance of ModifiedResourceException with thespecified detail message.

[0642] ModifiedResourceException(java.lang.String msg,java.lang.Throwable cause)

[0643] Constructs an instance of ModifiedResourceException with thespecified detail message.

[0644] ModifiedResourceException(java.lang.Throwable cause)

[0645] Creates a new instance of ModifiedResourceException withoutdetail message.

[0646] Methods inherited from Class java.lang.Throwable

[0647] fillInstackTrace, getcause, getLocalizedMessage, getMessage,getStackTrace, initcause, printStackTrace, printStackTrace,printStackTrace, setStackTrace, tostring

[0648] Methods inherited from Class java.lang.Object

[0649] clone, equals, finalize, getclass, hashcode, notify, notifyAll,wait, wait, wait

Constructor Detail

[0650] 1.1.9.1 ModifiedResourceException

[0651] public ModifiedResourceException ( )

[0652] Creates a new instance of ModifiedResourceException withoutdetail message.

[0653] 1.1.9.2 ModifiedResourceException

[0654] public ModifiedResourceException(java.lang.String msg)

[0655] Constructs an instance of ModifiedResourceException with thespecified detail message.

[0656] Parameters:

[0657] msg—the detail message.

[0658] 1.1.9.3 ModifiedResourceException

[0659] public ModifiedResourceException(java.lang.Throwable cause)

[0660] Creates a new instance of ModifiedResourceException withoutdetail message.

[0661] Parameters:

[0662] cause—the root cause of the exception

[0663] 1.1.9.4 ModifiedResourceException

[0664] public ModifiedResourceException(java.lang.String msg,java.lang.Throwable cause)

[0665] Constructs an instance of ModifiedResourceException with thespecified detail message.

[0666] Parameters:

[0667] msg—the detail message.

[0668] cause—the root cause of the exception

1.1.10 CLASS VALUEFIELDS

[0669]

[0670] public class ValueFields

[0671] extends java.lang.Object

[0672] Stores a string value and a collection of fields. Field Summaryprivate fields java.util.Collection The collection of fields. privatevalue java.lang.String The value.

Constructor Summary

[0673] ValueFields ( ) Method Summary java.util.Collection getFields( )Provides the fields. java.lang.String getValue( ) Provides the value.void setFields(java.util.Collection fields) Sets the fields. voidsetValue(java.lang.String value) Sets the value. java.lang.StringtoString( ) Provides a String representation of the constraint.

[0674] Methods inherited from Class java.lang.Object

[0675] clone, equals, finalize, getclass, hashcode, notify, notifyAll,wait, wait, wait _____,,,__,,, .......a. ..-.---.-.-.-.......................I........

Field Detail

[0676] 1.1.10.1 value

[0677] private java.lang.String value

[0678] The value.

[0679] 1.1.10.2 fields

[0680] private java.util.Collection fields

[0681] The collection of fields.

Constructor Detail

[0682] 1.1.10.3 ValueFields

[0683] public ValueFields ( )

[0684] 1.1.10.4 getValue

[0685] public java.lang.String getValue ( )

[0686] Provides the value.

[0687] Returns:

[0688] the value

[0689] 1.1.10.5 setValue

[0690] public void setValue(java.lang.String value)

[0691] Sets the value.

[0692] Parameters:

[0693] value—the value to search for

[0694] 1.1.10.6 getFields

[0695] public java.util.Collection getFields ( )

[0696] Provides the fields.

[0697] Returns:

[0698] the fields to search through

[0699] 1.1.10.7 setFields

[0700] public void setFields(java.util.Collection fields)

[0701] Sets the fields.

[0702] Parameters:

[0703] fields—the fields to search for

[0704] 1.1.10.8 toString

[0705] public java.lang.String toString ( )

[0706] Provides a String representation of the constraint.

[0707] Overrides:

[0708] tostring in class java.lang.Object

[0709] Returns:

[0710] a string representation of the constraint

1.1.11 INTERFACE BINARYCONTENT

[0711] public interface BinaryContent

[0712] Data holding class to store information on the binary contentassociated with an item. Method Summary int getContentLength( ) Get thecontent length of the input binary stream obtained. java.io.InputStreamgetContentStream( ) Get the content of the input binary stream obtained.java.lang.String getMimeType( ) Get the MIME type of the input binarystream obtained.

Method Detail

[0713] 1.1.11.1 getContentLength

[0714] public int getContentLength ( )

[0715] Get the content length of the input binary stream obtained.

[0716] Returns:

[0717] the length of the binary content

[0718] 1.1.11.2 getMimeType

[0719] public java.lang.String getMimeType ( )

[0720] Get the MIME type of the input binary stream obtained.

[0721] Returns:

[0722] the MIME type of the binary content.

[0723] 1.1.11.3 getContentStream

[0724] public java.io.InputStream getContentStream ( )

[0725] Get the content of the input binary stream obtained.

[0726] Returns:

[0727] an InputStream connected to the binary content.

1.1.12 INTERFACE CMSUSER

[0728] All Superinterfaces:

[0729] ObjectWithPrimaryKey

[0730] public interface CmsUser

[0731] extends ObjectWithPrimaryKey

[0732] A CmsUser is the end-user of the Content Management System, theactual user of the administration interface, or the user of the web siteetc. Method Summary void addCmsUserGroup(CmsUserGroup userGroup) Addsthe user to the specified CmsUserGroup java.util.Set getCmsUserGroups( )Returns a Set of all the CmsUserGroupS of which this CmsUser is amember. java.util.Set getCollections( ) Returns a Set of all theCollectionS that this user has access to. java.lang.String getEmail( )Returns the email of this CmsUser. java.lang.String getFirstName( )Returns the first name of this CmsUser. java.lang.String getLastName( )Returns the last name of this CmsUser. java.lang.String getPassword( )Returns the password of this CmsUser. java.lang.String getUsername( )Returns the username of this CmsUser. boolean isActive( ) Indicateswhether the user is active. void removeCmsUserGroup(CmsUserGroupuserGroup) Removes the user from the specified CmsUserGroup voidsetActive(boolean active) Sets whether the user is active. voidsetEmail(java.lang.String email) Sets the email of this CmsUser. voidsetFirstName(java.lang.String firstName) Sets the first name of thisCmsUser. void setLastName(java.lang.String lastName) Sets the last nameof this CmsUser. void setPassword(java.lang.String password) Sets thepassword of this CmsUser. void setUsername(java.lang.String username)Sets the username of this CmsUser.

[0733] Methods inherited from interfacecom.conceptis.cms.ObjectWithPrimaryKey

[0734]getPrimaryKey

Method Detail

[0735] 1.1.12.1 setUsername

[0736] public void setUsername(java.lang.String username)

[0737] throws AuthorizationException, ConnectionException

[0738] Sets the username of this CmsUser.

[0739] Parameters:

[0740] username—the name of this CmsUser

[0741] Throws:

[0742] AuthorizationException—if the current user does not havepermission to perform this operation

[0743] ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[0744] 1.1.12.2 getUsername

[0745] public java.lang.String getUsername ( )

[0746] throws AuthorizationException, ConnectionException

[0747] Returns the Username of this CmsUser.

[0748] Returns:

[0749] the Username of this CmsUser

[0750] Throws:

[0751]AuthorizationException—if the current user does not havepermission to perform this operation

[0752]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[0753] 1.1.12.3 setPassword

[0754] public void setPassword(java.lang.String password)

[0755] throws AuthorizationException, ConnectionException

[0756] Sets the password of this CmsUser.

[0757] Parameters:

[0758] password—the password of this CmsUser.

[0759] Throws:

[0760]AuthorizationException—if the current user does not havepermission to perform this operation

[0761]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[0762] 1.1.12.4 getPassword

[0763] public java.lang.String getpassword ( )

[0764] throws AuthorizationException, ConnectionException

[0765] Returns the password of this CmsUser. Note that someimplementations may throw an UnsupportedoperationException if it is notpossible to retreive a user's password from the data repository

[0766] Returns:

[0767] the password of this CmsUser; this may be null

[0768] Throws:

[0769]AuthorizationException—if the current user does not havepermission to perform this operation

[0770]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[0771] 1.1.12.5 setFirstName

[0772] public void setFirstName(java.lang.String firstName)

[0773] throws AuthorizationException, ConnectionException

[0774] Sets the first name of this CmsUser.

[0775] Parameters:

[0776] firstName—the first name of this CmsUser

[0777] Throws:

[0778]AuthorizationException—if the current user does not havepermission to perform this operation

[0779]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[0780] 1.1.12.6 getFirstName

[0781] public java.lang.String getFirstName ( )

[0782] throws AuthorizationException, ConnectionException

[0783] Returns the first name of this CmsUser.

[0784] Returns:

[0785] the first name of this CmsUser

[0786] Throws:

[0787]AuthorizationException—if the current user does not havepermission to perform this operation

[0788]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[0789] 1.1.12.7 setLastName

[0790] public void setLastName(java.lang.String lastName)

[0791] throws AuthorizationException, ConnectionException

[0792] Sets the last name of this CmsUser.

[0793] Parameters:

[0794] lastName—the last name of this CmsUser

[0795] Throws:

[0796]AuthorizationException—if the current user does not havepermission to perform this operation

[0797]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver i-plementation choses to usedefer ed data loading (frc performance reason).

[0798] 1.1.12.8 getLastName

[0799] public java.lang.String getLastName ( )

[0800] throws AuthorizationException, ConnectionException

[0801] Returns the last name of this CmsUser.

[0802] Returns:

[0803] the last name of this CmsUser

[0804] Throws:

[0805]AuthorizationException—if the current user does not havepermission to perform this operation

[0806]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[0807] 1.1.12.9 setEmail

[0808] public void setEmail(java.lang.String email)

[0809] throws AuthorizationException, ConnectionException

[0810] Sets the email of this CmsUser.

[0811] Parameters:

[0812] email—the email of this CmsUser

[0813] Throws:

[0814]AuthorizationException—if the current user does not havepermission to perform this operation

[0815]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[0816] 1.1.12.10 getEmail

[0817] public java.lang.String getEmail ( )

[0818] throws AuthorizationException, ConnectionException

[0819] Returns the email of this CmsUser.

[0820] Returns:

[0821] the email of this CmsUser

[0822] Throws:

[0823]AuthorizationException—if the current user does not havepermission to perform this operation

[0824]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[0825] 1.1.12.11 getCmsUserGroups

[0826] public java.util.Set getCmsUserGroups ( )

[0827] throws AuthorizationException, ConnectionException

[0828] Returns a Set of all the CmsUserGroupS of which this CmsUser is amember.

[0829] Returns:

[0830] a Set of all the CmsUserGroups of which this CmsUser is a member

[0831] Throws:

[0832]AuthorizationException—if the current user does not havepermission to perform this operation

[0833]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[0834] 1.1.12.12 addCmsUserGroup

[0835] public void addCmsUserGroup(CmsUserGroup userGroup)

[0836] throws AuthorizationException, ConnectionException

[0837] Adds the user to the specified CmsUserGroup

[0838] Parameters:

[0839] userGroup—the user group to add

[0840] Throws:

[0841]AuthorizationException—if the current user does not havepermission to perform this operation

[0842]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[0843] 1.1.12.13 removeCmsUserGroup

[0844] public void removeCmsUserGroup(CmsUserGroup userGroup)

[0845] throws AuthorizationException, ConnectionException

[0846] Removes the user from the specified CmsUserGroup

[0847] Parameters:

[0848] userGroup—the user group to remove

[0849] Throws:

[0850]AuthorizationException—if the current user does not havepermission to perform this operation

[0851]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[0852] 1.1.12.14 getCollections

[0853] public java.util.Set getCollections ( )

[0854] throws AuthorizationException, ConnectionException

[0855] Returns a Set of all the Collections that this user has accessto.

[0856] Returns:

[0857] the set of collections that the user has access to

[0858] Throws:

[0859]AuthorizationException—if the current user does not havepermission to perform this operation

[0860]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[0861] 1.1.12.15 isActive

[0862] public boolean isActive ( )

[0863] throws AuthorizationException, ConnectionException

[0864] Indicates whether the user is active. Inactive user's arerestricted in the actions they may perform.

[0865] Returns:

[0866] true if the user is active, false otherwise

[0867] Throws:

[0868]AuthorizationException—if the current user does not havepermission to perform this operation

[0869]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[0870] 1.1.12.16 setActive

[0871] public void setActive(boolean active)

[0872] throws AuthorizationException, ConnectionException

[0873] Sets whether the user is active. Inactive user's are restrictedin the actions they can perform.

[0874] Parameters:

[0875] active—true if the user is active, false otherwise

[0876] Throws:

[0877]AuthorizationException—if the current user does not havepermission to perform this operation

[0878]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

1.1.13 INTERFACE CMSUSERFACTORY

[0879] public interface CmsUserFactory

[0880] Interacts with the CMS to provide access to users of the CMS.Method Summary CmsUser createNewCmsUser( ) Creates a new CmsUserinstance, uninitialized, not stored in the CMS. voiddeleteCmsUser(CmsUser cmsUser) Deletes this CmsUser. CmsUsergetCmsUser(com.conceptis.util.PrimaryKey key) Provides the CmsUser withthe specified key CmsUser getCmsUser(java.lang.String username) Providesthe CmsUser with the specified username. java.util.Set getCmsUsers( )Provides the set of all CmsUserS in the CMS. void saveCmsUser(CmsUsercmsUser) Saves the specified CmsUser.

Method Detail

[0881] 1.1.13.1 getCmsUsers

[0882] public java.util.Set getCmsUsers ( )

[0883] throws ConnectionException, AuthorizationException

[0884] Provides the set of all CmsUsers in the CMS.

[0885] Returns:

[0886] the set of all CmsUsers (may be empty but never null)

[0887] Throws:

[0888]ConnectionException—if there is a problem interacting with the CMS

[0889]AuthorizationException—if the current user does not havepermission to perform this operation

[0890] 1.1.13.2 getCmsUser

[0891] public CmsUser getCmsUser(com.conceptis.util.PrimaryKey key)

[0892] throws ConnectionException, AuthorizationException,MissingResourceException

[0893] Provides the CmsUser with the specified key

[0894] Parameters:

[0895]

[0896] key—the primary key of the CmsUser

[0897] Returns:

[0898] the CmsUser with the specified key

[0899] Throws:

[0900]ConnectionException—if there is a problem interacting with the CMS

[0901]AuthorizationException—if the current user does not havepermission to perform this operation

[0902]MissingResourceException—if the CmsUser specified by the key doesnot exist

[0903] 1.1.13.3 getCmsUser

[0904] public CmsUser getCmsUser(java.lang.String Username)

[0905] throws ConnectonException, AuthorizationException,MissingResourceException

[0906] Provides the CmsUser with the specified Username.

[0907] Parameters:

[0908] Username—the Username being searched for

[0909] Returns:

[0910] the CmsUser with the specified Username

[0911] Throws:

[0912]ConnectionException—if there is a problem interacting with the CMS

[0913]AuthorizationException—if the current user does not havepermission to perform this operation

[0914]MissingResourceException—if the CmsUser specified by the key doesnot exist

[0915] 1.1.13.4 createNewCmsUser

[0916] public CmsUser createNewCmsUser ( )

[0917] Creates a new CmsUser instance, uninitialized, not stored in theCMS. Once correctly initialized, this instance may then be inserted inthe CMS using the saveCmsUser (com. conceptis. cms. CmsUser) method.

[0918] Returns:

[0919] the newly created CmsUser

[0920] 1.1.13.5 saveCmsUser

[0921] public void saveCmsUser(CmsUser cmsUser)

[0922] throws ConnectionException, AuthorizationException,MissingResourceException

[0923] Saves the specified CmsUser. This will change the CmsUser's entryin the CMS to reflect the state of the cmsUser parameter.

[0924] Parameters:

[0925] CmsUser—the <CODECMSUSER<code>to insert/update

[0926] Throws:

[0927]ConnectionException—if there is a problem interacting with the CMS

[0928]AuthorizationException—if the current user does not havepermission to perform this operation

[0929]MissingResourceException—if a previously existing CmsUser does notexist any longer

[0930] 1.1.13.6 deleteCmsUser

[0931] public void deleteCmsUser(CmsUser CmsUser)

[0932] throws ConnectionException, AuthorizationException,MissingResourceException

[0933] Deletes this CmsUser. This may have unintended consequences. Notethat some implementations may throw an UnsupportedoperationException ifthe deletion of CmsUserS is not possible.

[0934] Parameters:

[0935] CmsUser—the CmsUser to delete

[0936] Throws:

[0937]ConnectionException—if there is a problem interacting with the CMS

[0938]AuthorizationException—if the current user does not havepermission to perform this operation

[0939]MissingResourceException—if the CmsUser does not exist any longer

1.1.14 INTERFACE CMSUSERGROUP

[0940] All Superinterfaces:

[0941] ObjectWithPrimaryKey

[0942] public interface CmsUserGroup

[0943] extends ObjectWithPrimaryKey

[0944] A CmsUserGroup is used to grant security-related permissions to agroup of CmsUsers. Method Summary void addCmsUser(CmsUser cmsUser)Registers the given CmsUser as a member of this CmsUserGroup.java.util.Set getCmsUsers( ) Returns a Set of all the CmsUserS that areregistered as member of this CmsUserGroup. java.util.Set getCollections() Provides the set of collections that this group has access to.java.lang.String getName( ) Returns the name of this CmsUserGroup. voidremoveCmsUser(CmsUser cmsUser) Unregisters the given CmsUser as a memberof this CmsUserGroup. void setName(java.lang.String name) Sets the nameof this CmsUserGroup.

[0945] Methods inherited from interfacecom.conceptis.cms.ObjectWithPrimaryKey

[0946] getPrimaryKey

Method Detail

[0947] 1.1.14.1 setName

[0948] public void setName(java.lang.String name)

[0949] throws AuthorizationException, ConnectionException

[0950] Sets the name of this CmsUserGroup.

[0951] Parameters:

[0952] name—the name of this CmsUserGroiLp

[0953] Throws:

[0954]AuthorizationException—if the current user does not havepermission to perform this operation

[0955]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[0956] 1.1.14.2 getName

[0957] public java.lang.String getName ( )

[0958] throws AuthorizationException, ConnectionException

[0959] Returns the name of this CmsUserGroup.

[0960] Returns:

[0961] the name of this CmsUserGroup

[0962] Throws:

[0963]AuthorizationException—if the current user does not havepermission to perform this operation

[0964]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[0965] 1.1.14.3 addCmsUser

[0966] public void addCmsUser(CmsUser cmsUser)

[0967] throws AuthorizationException, ConnectionException

[0968] Registers the given CmsUser as a member of this CmsUserGroup.

[0969] Parameters:

[0970] CmsUser—the CmsUser to register as a member of this CmsUserGroup

[0971] Throws:

[0972]AuthorizationException—if the current user does not havepermission to perform this operation

[0973]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[0974] 1.1.14.4 removeCmsUser

[0975] public void removeCmsUser(CmsUser CmsUser)

[0976] throws AuthorizationException, ConnectionException

[0977] Unregisters the given CmsUser as a member of this CmsUserGroup.

[0978] Parameters:

[0979] CmsUser—the CmsUser to unregister as a member of thisCmsUserGroup

[0980] Throws:

[0981]AuthorizationException—if the current user does not havepermission to perform this operation

[0982]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver impnenle tntion choses touse deferred data loading (for performance reason).

[0983] 1.1.14.5 getCmsUsers

[0984] public java.util.Set getCmsUsers ( )

[0985] throws AuthorizationException, ConnectionException

[0986] Returns a Set of all the CmsUsers that are registered as memberof this CmsUserGroup.

[0987] Returns:

[0988] a Set of all the CmsUsers that are registered as member of thisCmsUserGroup

[0989] Throws:

[0990]AuthorizationException—if the current user does not havepermission to perform this operation

[0991]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[0992] 1.1.14.6 getCollections

[0993] public java.util.Set getCollections ( )

[0994] throws AuthorizationException, ConnectionException

[0995] Provides the set of collections that this group has access to.

[0996] Returns:

[0997] the set of collections that this group has access to

[0998] Throws:

[0999]AuthorizationException—if the current user does not havepermission to perform this operation

[1000]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1001] 1.1.15 INTERFACE CMSUSERGROUPFACTORY

[1002] public interface CmsUserGroupFactory

[1003] A CmsUserGroupFactory interacts directly with the CMS server toperform any action that creates, modifies, deletes or simply loads thedata of the CmsUserGroupS. Method Summary CmsUserGroupcreateNewCmsUserGroup( ) Creates a new CmsUserGroup instance,uninitialized, not stored in the CMS. voiddeleteCmsUserGroup(CmsUserGroup cmsUserGroup) Deletes this CmsuserGroup.CmsUserGroup getCmsUserGroup(com.conceptis.util.PrimaryKey key) Providesthe CmsUserGroup with the specified key. java.util.Set getCmsUserGroups() Returns a Set containing all the CmsUserGroupS defined in our CMS.void saveCmsUserGroup(CmsUserGroup cmsUserGroup) Saves the specifiedCmsUserGroup.

Method Detail

[1004] 1.1.15.1 getCmsUserGroups

[1005] public java.util.Set getCmsUserGroups ( )

[1006] throws ConnectionException, AuthorizationException

[1007] Returns a Set containing all the CmsUserGroups defined in ourCMS.

[1008] Returns:

[1009] a Set of all CmsUserGroupS (may be empty but never null)

[1010] Throws:

[1011]ConnectionException—if there is a problem interacting with the CMS

[1012]AuthorizationException—if the current user does not havepermission to perform this operation

[1013] 1.1.15.2 getCmsUserGroup

[1014] public CmsUserGroup getCmsUserGroup(com.conceptis.util.PrimaryKeykey)

[1015] throws ConnectionException, AuthorizationException,MissingResourceException

[1016] Provides the CmsUserGroup with the specified key.

[1017] Parameters:

[1018] key—the primary key of the CmsUserGroup

[1019] Returns:

[1020] the CmsUserGroup with the specified key

[1021] Throws:

[1022]ConnectionException—if there is a problem interacting with the CMS

[1023]AuthorizationException—if the current user does not havepermission to perform this operation

[1024]MissingResourceException—if the CmsUserGroup specified by the keydoes not exist

[1025] 1.1.15.3 createNewCmsUserGroup

[1026] public CmsUserGroup createN wCmsUserGroup ( )

[1027] Creates a new CmsUserGroup instance, uninitialized, not stored inthe CMS. Once correctly initialized, this instance may then be insertedin the CMS using the saveCmsUserGroup (com. conceptis. cms.CmsUserGroup) method.

[1028] Returns:

[1029] the newly created CmsUserGroup

[1030] 1.1.15.4 saveCmsUserGroup

[1031] public void saveCmsUserGroup(CmsUserGroup cmsUserGroup)

[1032] throws ConnectionException, AuthorizationException,MissingResourceException

[1033] Saves the specified CmsUserGroup. This will change theCmsUserGroup's entry in the

[1034] CMS to reflect the state of the CmsUserGroup parameter.

[1035] Parameters:

[1036] cmsUserGroup—the CmsUserGroup to insert/update

[1037] Throws:

[1038]ConnectionException—if there is a problem interacting with the CMS

[1039]AuthorizationException—if the current user does not havepermission to perform this operation

[1040]MissingResourceException—if a previously existing CmsUserGroupdoes not exist any longer

[1041] 1.1.15.5 deleteCmsUserGroup

[1042] public void deleteCmsUserGroup(CmsUserGroup cmsUserGroup)

[1043] throws ConnectionException, AuthorizationException,MissingResourceException

[1044] Deletes this CmsUserGroup. This may have unintended consequences.Note that some implementations may throw anUnsupportedoperationException if the deletion of CmsUserGroups is notpossible.

[1045] Parameters:

[1046] cmsUserGroup—the CMsUserGroup to delete

[1047] Throws:

[1048]ConnectionException—if there is a problem interacting with the CMS

[1049]AuthorizationException—if the user does not have permission toperform this operation

[1050]MissingResourceException—if the CmsUserGroup does not exist anylonger

1.1.16 INTERFACE COLLECTION

[1051] All Superinterfaces:

[1052] extends ObjectWithPrimaryKey

[1053] public interface Collection

[1054] extends ObjectWithPrimaryKey

[1055] A Collection is used to regroup several ItemS together, and canbe used to globally assign security properties. Method Summary voidaddGroupAccess(CmsUserGroup group) Adds a group that has access to thiscollection. void addItem(Item item) Adds an item to this collection.void addUserAccess(CmsUser userToAdd) Adds a user that has access tothis collection. java.util.Set getCmsUsers( ) Provides the set ofCmsUserS that have access to this collection. java.util.Set getGroups( )Provides the set of groups that have access to this collection.java.util.Set getItems( ) Provides the set of ItemS that are present inthis collection. java.lang.String getName( ) Returns the name of thisCollection. void removeGroupAccess(CmsUserGroup group) Removes a groupfrom the access list of this collection. void removeItem(Item item)Removes an item from this collection. void removeUserAccess(CmsUseruserToRemove) Removes a user from the access list of this collection.void setName(java.lang.String name) Sets the name of this Collection.

[1056] Methods inherited from interfacecom.conceptis.cms.ObjectWithPrimaryKey

[1057] getPrimaryKey

[1058] 1.1.16.1 setName

[1059] public void setName(java.lang.String name)

[1060] throws AuthorizationException, ConnectionException

[1061] Sets the name ofthis Collection.

[1062] Parameters:

[1063] name—the name of this Collection

[1064] Throws:

[1065]AuthorizationException—if the current user does not havepermission to perform this operation

[1066]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1067] 1.1.16.2 getName

[1068] public java.lang.String getName ( )

[1069] throws AuthorizationException, ConnectionException

[1070] Returns the name of this Collection.

[1071] Returns:

[1072] the name of this Collection

[1073] Throws:

[1074]AuthorizationException—if the current user does not havepermission to perform this operation

[1075]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1076] 1.1.16.3 addGroupAccess

[1077] public void addGroupAccess(CmsUserGroup group)

[1078] throws AuthorizationException, ConnectionException

[1079] Adds a group that has access to this collection. If the groupalready has access to this collection, this method will do nothing, butwill not complain.

[1080] Parameters:

[1081] group—the group to add to the access list of this collection

[1082] Throws:

[1083]AuthorizationException—if the current user does not havepermission to perform this operation

[1084]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1085] 1.1.16.4 removeGroupAccess

[1086] public void removeGroupAccess(CmsUserGroup group)

[1087] throws AuthorizationException, ConnectionException

[1088] Removes a group from the access list of this collection. If thegroup did not have access to this collection, this method will donothing, but will not complain.

[1089] Parameters:

[1090] group—the group to remove from the access list of this collection

[1091] Throws:

[1092]AuthorizationException—if the current user does not havepermission to perform this operation ConnectionException—if there is aproblem interacting with the CMS; this will only be thrown if the driverimplementation choses to use deferred data loading (for performancereason).

[1093] 1.1.16.5 getGroups

[1094] public java.util.Set getGroups ( )

[1095] throws AuthorizationException, ConnectionException,

[1096] MissingResourceException

[1097] Provides the set of groups that have access to this collection.

[1098] Returns:

[1099] the set of the code>CmsGroups that have access, in no particularorder

[1100] Throws:

[1101]AuthorizationException—if the current user does not havepermission to perform this operation

[1102]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1103]MissingResourceException—if the groups cannot be accessed

[1104] 1.1.16.6 addUserAccess

[1105] public void addUserAccess(CmsUser userToAdd)

[1106] throws AuthorizationException, ConnectionException

[1107] Adds a user that has access to this collection. If the useralready has access to this collection, this method will do nothing, butwill not complain.

[1108] Parameters:

[1109] userToAdd—the user to add to the access list for this collection

[1110] Throws:

[1111]AuthorizationException—if the current user does not havepermission to perform this operation

[1112]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1113] 1.1.16.7 removeUserAccess

[1114] public void removeuserAccess(CmsUser userToRemove)

[1115] throws AuthorizationException, ConnectionException

[1116] Removes a user from the access list of this collection. If theuser did not have access to this collection, this method will donothing, but will not complain.

[1117] Parameters:

[1118] userToRemove—the user to remove from the access list of thiscollection

[1119] Throws:

[1120]AuthorizationException—if the current user does not havepermission to perform this operation

[1121]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1122] 1.1.16.8 getCmsUsers

[1123] public java.util.Set getCmsUsers ( )

[1124] throws AuthorizationException, ConnectionException,MissingResourceException

[1125] Provides the set of CmsUsers that have access to this collection.

[1126] Returns:

[1127] the set of the users that have access, in no particular order

[1128] Throws:

[1129]AuthorizationException—if the current user does not havepermission to perform this operation

[1130]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1131]MissingResourceException—if the users cannot be accessed

[1132] 1.1.16.9 addItem

[1133] public void addItem(Item item)

[1134] throws AuthorizationException, ConnectionException

[1135] Adds an item to this collection. If the item was already in thecollection, this method will do nothing, but will not complain

[1136] Parameters:

[1137] item—the item to add to this collection

[1138] Throws:

[1139]AuthorizationException—if the current user does not havepermission to perform this operation

[1140]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1141] 1.1.16.10 removeItem

[1142] public void removeItem(Item item)

[1143] throws AuthorizationException, ConnectionException

[1144] Removes an item from this collection. If the item was not in thecollection, this method will do nothing, but will not complain.

[1145] Parameters:

[1146] item—the item to remove from this collection

[1147] Throws:

[1148]AuthorizationException—if the current user does not havepermission to perform this operation P ConnectionException—if there is aproblem interacting with the CMS; this will only be thrown if the driverimplementation choses to use deferred data loading (for performancereason).

[1149] 1.1.16.11 getItems

[1150] public java.util.Set getItems ( )

[1151] throws AuthorizationException, ConnectionException

[1152] Provides the set of Items that are present in this collection.

[1153] Returns:

[1154] the set of the items in the collection, in no particular order

[1155] Throws:

[1156]AuthorizationException—if the current user does not havepermission to perform this operation

[1157]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

1.1.17 INTERFACE COLLECTION FACTORY

[1158] public interface CollectionFactory

[1159] Interacts with the CMS to provide access to collections of theCMS. Method Summary Collection createNewCollection( ) Creates a newCollection instance, uninitialized, not stored in the CMS. voiddeleteCollection(Collection collection) Deletes this Collection.Collection getCollection(com.conceptis.util.PrimaryKey key) Provides theCollection with the specified key. java.util.Set getCollections( )Provides the set of all CollectionS. void saveCollection(Collectioncollection) Saves the specified Collection.

Method Detail

[1160] 1.1.17.1 getcollections

[1161] public java.util.Set getcollections ( )

[1162] throws ConnectionException, AuthorizationException

[1163] Provides the set of all Collections.

[1164] Returns:

[1165] the set of all Collection (may be empty but never null)

[1166] Throws:

[1167]ConnectionException—if there is a problem interacting with the CMS

[1168]AuthorizationException—if the current user does not havepermission to perform this operation

[1169] 1.1.17.2 getCollection

[1170] public Collection getCollection(com.conceptis.util.PrimaryKeykey)

[1171] throws ConnectionException, AuthorizationException,MissingResourceException

[1172] Provides the Collection with the specified key.

[1173] Parameters:

[1174] key—the primary key of the Collection

[1175] Returns:

[1176] the Collection with the specified key

[1177] Throws:

[1178]ConnectionException—if there is a problem interacting with the CMS

[1179]AuthorizationException—if the current user does not havepermission to perform this operation

[1180]MissingResourceException—if the Collection specified by the keydoes not exist

[1181] 1.1.17.3 createNewCollection

[1182] public Collection createNewCollection ( )

[1183] Creates a new Collection instance, uninitialized, not stored inthe CMS. Once correctly initialized, this instance may then be insertedin the CMS using the saveCollection(com.conceptis.cms.Collection)method.

[1184] Returns:

[1185] the newly created Collection

[1186] 1.1.17.4 saveCollection

[1187] public void saveCollection(Collection collection)

[1188] throws ConnectionException, AuthorizationException,MissingResourceException

[1189] Saves the specified Collection. This will change the Collection'sentry in the CMS to reflect the state of the collection parameter.

[1190] Parameters:

[1191] collection—the Collection to insert/update

[1192] Throws:

[1193]ConnectionException—if there is a problem interacting with the CMS

[1194]AuthorizationException—if the current user does not havepermission to perform this operation

[1195]MissingResourceException—if a previously existing Collection doesnot exist any longer

[1196] 1.1.17.5 deleteCollection

[1197] public void deleteCollection(Collection collection)

[1198] throws ConnectionException, AuthorizationException,MissingResourceException

[1199] Deletes this Collection. This may have unintended consequences.Note that some implementations may throw anUnsupportedOperationException if the deletion of Collections is notpossible.

[1200] Parameters:

[1201] collection—the Collection to delete

[1202] Throws:

[1203]ConnectionException—if there is a problem interacting with the CMS

[1204]AuthorizationException—if the user does not have permission toperform this operation

[1205]MissingResourceException—if the Collection does not exist anylonger

1.1.18 INTERFACE CONNECTION

[1206] public interface Connection

[1207] Provides access to factories that can be used to interact withthe CMS. Method Summary void clearCaches( ) Clears the caches of allfactories. void close( ) Closes the connection.com.conceptis.util.PrimaryKey createPrimaryKey(java.lang.String key)This method returns a PrimaryKey of the appropriate type. CmsUserFactorygetCmsUserFactory( ) Provides a CmsUserFactory that utilizes thisconnection. CmsUserGroupFactory getCmsUserGroupFactory( ) Provides aCmsUserGroupFactory that utilizes this connection. CollectionFactorygetCollectionFactory( ) Provides a CollectionFactory that utilizes thisconnection. IndexFactory getIndexFactory( ) Provides a IndexFactory thatutilizes this connection. ItemFactory getItemFactory( ) Provides aItemFactory that utilizes this connection. ItemTypeFactorygetItemTypeFactory( ) Provides a ItemTypeFactory that utilizes thisconnection. CmsUser getOwner( ) This method returns the CmsUserassociated with this connection. PublicationStatusFactorygetPublicationStatusFactory( ) Provides a PublicationFlowFactory thatutilizes this connection. RelationTypeFactory getRelationTypeFactory( )Provides a RelationTypeFactory that utilizes this connection.java.lang.String getURL( ) This method provides the URL that was used toestablish the connection. boolean isValid( ) This method returns true ifthis Connection can still be used to connect to the CMS.

Method Detail

[1208] 1.1.18.1 close

[1209] public void close ( )

[1210] throws ConnectionException

[1211] Closes the connection. This frees up whatever resources were inuse to interact with the CMS.

[1212] Throws:

[1213]ConnectionException—if there is a problem closing the connection

[1214] 1.1.18.2 getCmsUserFactory

[1215] public CmsUserFactory getCmsUserFactory ( )

[1216] Provides a CmsUserFactory that utilizes this connection.

[1217] Returns:

[1218] a factory for CmsUsers.

[1219] 1.1.18.3 getCmsUserGroupFactory

[1220] public CmsUserGroupFactory getCmsUserGroupFactory ( )

[1221] Provides a CMsUserGroupFactory that utilizes this connection.

[1222] Returns:

[1223] a factory for CmsUserGroups.

[1224] 1.1.18.4 getCollectionFactory

[1225] public CollectionFactory getCollectionFactory ( )

[1226] Provides a CollectionFactory that utilizes this connection.

[1227] Returns:

[1228] a factory for Collections.

[1229] 1.1.18.5 getItemFactory

[1230] public ItemFactory getItemFactory ( )

[1231] Provides a ItemFactory that utilizes this connection.

[1232] Returns:

[1233] 1.1.18.6 getItemTypeFactory

[1234] public ItemTypeFactory getItemTypeFactory ( )

[1235] Provides a ItemTypeFactory that utilizes this connection.

[1236] Returns:

[1237] a factory for CollectionTypeS.

[1238] 1.1.18.7 getPublicationStatusFactory

[1239] public PublicationStatusFactory getPublicationStatusFactory ( )

[1240] Provides a PublicationFlowFactory that utilizes this connection.

[1241] Returns:

[1242] a factory for PublicationFlowS.

[1243] 1.1.18.8 getRelationTypeFactory

[1244] public RelationTypeFactory getRelationTypeFactory ( )

[1245] Provides a RelationTypeFactory that utilizes this connection.

[1246] Returns:

[1247] a factory for RelationTypeS.

[1248] 1.1.18.9 getIndexFactory

[1249] public IndexFactory getIndexFactory ( )

[1250] Provides a IndexFactory that utilizes this connection.

[1251] Returns:

[1252] a factory for Indexes.

[1253] 1.1.18.10 isValid

[1254] public boolean isValid ( )

[1255] This method returns true if this connection can still be used toconnect to the CMS.

[1256] The validation procedure is driver-dependent, but must be verylight (almost no data transfer) and fast, because this operation may beperformed very often (by a pooling mechanism for example).

[1257] Returns:

[1258] true is this connection is still valid; false otherwise.

[1259] 1.1.18.11 getOwner

[1260] public CmsUser getOwner ( )

[1261] This method returns the CmsUser associated with this connection.Since methods may throw AuthorizationExceptions depending on thesecurity permissions for this user, it is useful for business logic tobe able to preemptively know whether or not these operations will besuccessful prior to calling them. Using this method, this becomespossible.

[1262] Returns:

[1263] The CmsUser associated with this connection.

[1264] 1.1.18.12 createPrimaryKey

[1265] public com.conceptis.util.PrimaryKeycreatePrimaryKey(java.lang.String key)

[1266] This method returns a PrimaryKey of the appropriate type. SincePrimaryKeys will often be in a serialized form, this method allows theinstantiation of the appropriate key type.

[1267] Parameters:

[1268] key—The string (serialized) representation of the primary key,typically received from a web application.

[1269] Returns:

[1270] The PrimaryKey associated with the specified parameter.

[1271] 1.1.18.13 getURL

[1272] public java.lang.String getURL ( )

[1273] This method provides the URL that was used to establish theconnection.

[1274] Returns:

[1275] the URL used to establish the connection

[1276] 1.1.18.14 clearCaches

[1277] public void clearcaches ( )

[1278] Clears the caches of all factories.

1.1.19 INTERFACE DRIVER

[1279] public interface Driver

[1280] Represents a driver for a CMS. The driver is able to provideConnections to objects that request them, with the correct URL and setof credentials (Username, password, etc—driver dependent information).

[1281] A well behaved implementation of the Driver interface is expectedto register itself with the DriverManager class when the class is firstloaded. A failure to do this will result in the driver implementationbeing unavilable to the runtime environment.

[1282] See Also:

[1283] DriverManager Method Summary boolean acceptsURL(java.lang.Stringurl) Tests whether this driver understands the specified URL. Connectionconnect(java.lang.String url, java.util.Properties properties) Opens aconnection to the specified URL.

Method Detail

[1284] 1.1.19.1 connect

[1285] public Connection connect(java.lang.String url,java.util.Properties properties)

[1286] throws ConnectionException, AuthenticationException,AuthorizationException

[1287] Opens a connection to the specified URL.

[1288] Parameters:

[1289] url—the url to open a connection to.

[1290] properties—configuration options for the desired connection

[1291] Returns:

[1292] a connection to the CMS (null if it could not be opened)

[1293] Throws:

[1294]ConnectionException—thrown if there is a problem

[1295]AuthenticationException—thrown if the usemame/password combinationis invalid

[1296]AuthorizationException—if the site is inaccessible

[1297] 1.1.19.2 acceptsURL

[1298] public boolean acceptsURL(java.lang.String url)

[1299] Tests whether this driver understands the specified URL.

[1300] Parameters:

[1301] url—the url to test

[1302] Returns:

[1303] true if the driver believes it can handle the url, falseotherwise

[1304] 1.1.20 INTERFACE FIELD

[1305] All Superinterfaces:

[1306] ObjectWithPrimaryKey

[1307] public interface Field

[1308] extends ObjectWithPrimaryKey

[1309] A Field is an editable parameter. Their behavior are defined inItemTypes(valid values, type, etc.), and the values are assigned whenusing an Item. Field Summary static int TYPE DATE Fields of typeTYPE_DATE hold an instance of java.util.Date. static int TYPE INTEGERFields of type TYPE_INTEGER hold an instance of java.lang.Integer.static int TYPE PHONE NUMBER Fields of type TYPE_PHONE_NUMBER hold aninstance of java.lang.String that must respect a specific format. staticint TYPE POSTAL CODE Fields of type TYPE_POSTAL_CODE hold an instance ofjava.lang.String that must respect a specific format. static int TYPESTRING Fields of type TYPE_STRING hold an instance of java.lang.Stringwith no specific constraint. static int TYPE URL Fields of type TYPE_URLhold an instance of java.net.URL. static int TYPE XML Fields of typeTYPE_XML hold an instance of java.lang.String that must be a valid XMLstring. Method Summary void addValidValue(java.lang.Object value) Adds anew valid value for this Field definition. java.lang.ObjectgetDefaultValue( ) Provides the default value for this Field definition.int getFieldType( ) Returns the type of this Field. java.lang.StringgetHelpText( ) Provides the help text for the field, if available.java.lang.String getName( ) Returns the name of this Field. intgetOrder( ) Provides the order of the field. int getPage( ) Provides thepage number of the field, used for display purposes. java.lang.StringgetPageDescription( ) Provides the name of the page the field is on.java.lang.String getServerName( ) Provides the server name of this Fieldjava.util.Set getValidValues( ) Returns a Set of all valid valuesdefined for this Field. boolean isEditable( ) This feature is notsupported in this version of the CMS API, and will always throw anUnsupportedOperationException. boolean isMandatory( ) Indicates whetherthe field is mandatory. void removeValidValue(java.lang.Object value)Removes a valid value for this Field definition. voidsetDefaultValue(java.lang.Object value) Sets the default value for thisField definition. void setEditable(boolean editable) This feature is notsupported in this version of the CMS API, and will always throw anUnsupportedOperationException. void setFieldType(int newType) Stes thetype of this Field. void setMandatory(boolean mandatory) Sets whetherthe field is mandatory or not. void setName(java.lang.String name) Setsthe name of this Field. void setServerName(java.lang.String name) Setsthe name of this Field. boolean validateValue(java.lang.Object value)This helper method provides a way to validate a value before setting itin an Item.

[1310] Methods inherited from interfacecom.conceptis.cms.ObjectWithPrimaryKey

[1311] getPrimaryKey

Field Detail

[1312] 1.1.20.1 TYPE_STRING

[1313] public static final int TYPE_STRING

[1314] Fields of type TYPE_STRING hold an instance of java.lang. Stringwith no specific constraint.

[1315] See Also:

[1316] Constant Field Values

[1317] 1.1.20.2 TYPE_INTEGER

[1318] public static final int TYPE_INTEGER

[1319] Fields of type TYPE_INTEGER hold an instance ofjava.lang.Integer.

[1320] See Also:

[1321] Constant Field Values

[1322] 1.1.20.3 TYPE_DATE

[1323] public static final int TYPE_DATE

[1324] FieldS of type TYPE_DATE hold an instance of java.util.Date.

[1325] See Also:

[1326]Constant Field Values

[1327] 1.1.20.4 TYPE_URL

[1328] public static final int TYPE_URL

[1329] Fields of type TYPE_URL hold an instance of java.net.URL.

[1330] See Also:

[1331]Constant Field Values

[1332] 1.1.20.5 TYPE_PHONE_NUMBER

[1333] public static final int TYPE_PHONE_NUMBER

[1334] Fields of type TYPE_PHONE_NUMBER hold an instance of java.lang.String that must respect a specific format.

[1335] See Also:

[1336]Constant Field Values

[1337] 1.1.20.6 TYPE_POSTAL_CODE

[1338] public static final int TYPE_POSTAL_CODE

[1339] Fields of type TYPE_POSTAL_CODE hold an instance of java.lang.String that must respect a specific format.

[1340] See Also:

[1341]Constant Field Values

[1342] 1.1.20.7 TYPE_XML

[1343] public static final int TYPE_XML

[1344] Fields of type TYPE_XML hold an instance of java.lang.String thatmust be a valid XML string.

[1345] See Also:

[1346]Constant Field Values

Method Detail

[1347] 1.1.20.8 setName

[1348] public void setName(java.lang.String name)

[1349] throws AuthorizationException, ConnectionException

[1350] Sets the name of this Field.

[1351] Parameters:

[1352] name—the name of this Field

[1353] Throws:

[1354]AuthorizationException—if the current user does not havepermission to perform this operation ConnectionException—if there is aproblem interacting with the CMS; this will only be thrown if the driverimplementation choses to use deferred data loading (for performancereason).

[1355] 1.1.20.9 getName

[1356] public java.lang.String getName ( )

[1357] throws AuthorizationException, ConnectionException

[1358] Returns the name of this Fiel

[1359] Returns:

[1360] the name of this Field

[1361] Throws:

[1362]AuthorizationException—if the current user does not havepermission to perform this operation

[1363]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1364] 1.1.20.10 getServerName

[1365] public java.lang.string getServerName ( )

[1366] throws AuthorizationException, ConnectionException

[1367] Provides the server name of this Field

[1368] Returns:

[1369] the server name of this field

[1370] Throws:

[1371]AuthorizationException—if the current user does not havepermission to perform this operation

[1372]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1373] 1.1.20.11 setServerName

[1374] public void setServerName(java.lang.String name)

[1375] throws AuthorizationException, ConnectionException

[1376] Sets the name of this Field.

[1377] Parameters:

[1378] name—the server name of this Field

[1379] Throws:

[1380]AuthorizationException—if the current user does not havepermission to perform this operation

[1381]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1382] 1.1.20.12 isEditable

[1383] public boolean isEditable ( )

[1384] throws AuthorizationException, ConnectionException

[1385] This feature is not supported in this version of the CMS API, andwill always throw an UnsupportedoperationException.

[1386] Indicates whether the field is editable.

[1387] Returns:

[1388] true if the field is editable, false othervvise

[1389] Throws:

[1390]AuthorizationException—if the current user does not havepermission to perform this operation

[1391]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1392] 1.1.20.13 setEditable

[1393] public void setEditable(boolean editable)

[1394] throws AuthorizationException, ConnectionException

[1395] This feature is not supported in this version of the CMS API, andwill always throw an UnsupportedoperationException.

[1396] Sets the editability of the field.

[1397] Parameters:

[1398] editable—true if the field should be editable, false otherwise

[1399] Throws:

[1400]AuthorizationException—if the current user does not havepermission to perform this operation

[1401]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1402] 1.1.20.14 isMandatory

[1403] public boolean isMandatory ( )

[1404] throws AuthorizationException, ConnectionException

[1405] Indicates whether the field is mandatory.

[1406] Returns:

[1407] true if the field is mandatory, false otherwise

[1408] Throws:

[1409]AuthorizationException—if the current user does not havepermission to perform this operation

[1410]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1411] 1.1.20.15 setMandatory

[1412] public void setMandatory(boolean mandatory)

[1413] throws AuthorizationException, ConnectionException

[1414] Sets whether the field is mandatory or not.

[1415] Parameters:

[1416] mandatory—true if the field is mandatory, false otherwise

[1417] Throws:

[1418]AuthorizationException—if the current user does not havepermission to perform this operation

[1419]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1420] 1.1.20.16 getFieldType

[1421] public int getFieldType ( )

[1422] throws AuthorizationException, ConnectionException

[1423] Returns the type of this Field. The returned value should be oneof the defined Field.TYPE_XYZ constants.

[1424] Returns:

[1425] an integer representing the type of field (see the Field.TYPE_XYZ constants for the accepted values)

[1426] Throws:

[1427]AuthorizationException—if the current user does not havepermission to perform this operation

[1428]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1429] 1.1.20.17 setFieldType

[1430] public void setFieldType(int newType)

[1431] throws AuthorizationException, ConnectionException

[1432] Stes the type of this Field. The specified value should be one ofthe defined Field.TYPE_XYZ constants.

[1433] Parameters:

[1434] newType—integer representing the type of field(see the Field.TYPE_XYZ constants for the accepted values)

[1435] Throws:

[1436]AuthorizationException—if the current user does not havepermission to perform this operation

[1437]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1438] 1.1.20.18 validateValue

[1439] public boolean validateValue(java.lang.Object value)

[1440] throws AuthorizationException, ConnectionException

[1441] This helper method provides a way to validate a value beforesetting it in an Item. It will check if the specified value respects theconstraints set by this Field, such as the Class. the value itself (ifit must be within a restricted set of allo.wed values), etc. The set ofvalid values can be modified using addval idvalue (java. lang .Obj ect)and removevalidvalue (java. lang. Object). If no valid value is defined,then any value would be acceptable, unless this method disagrees forsome other reason.

[1442] Parameters:

[1443] value—the Object that may become the corresponding value in anItem for this Field definition.

[1444] Returns:

[1445] true if the value respects the constraints defined by this Fielddefinition

[1446] Throws:

[1447]AuthorizationException—if the user does not have permission toperform this operation

[1448]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1449] 1.1.20.19 addValidValue

[1450] public void addvalidValue(java.lang.Object value)

[1451] throws java.lang.IllegalArgumentException, AuthorizationException

[1452] Adds a new valid value for this Field definition. This means thatthe validateValue (java.lang.Object) will only return true if thespecified value equals one of the valid values defined through thismethod.

[1453] Parameters:

[1454] value—the valid value to add to the Set.

[1455] Throws:

[1456] java.lang.IllegalArgumentException—if the value parameter doesn'teven respect the basic constraints of this Field definition (such a theClass) AuthorizationException—if the the user cannot access thisinformation

[1457] 1.1.20.20 getValidValues

[1458] public java.util.Set getValidValues ( )

[1459] throws AuthorizationException, ConnectionException

[1460] Returns a Set of all valid values defined for this Field. Ifempty, this means that any value respecting the basic constraints isacceptable.

[1461] Returns:

[1462] a Set of all valid values defined for this Field. Can be emtpybut never null

[1463] Throws:

[1464]AuthorizationException—if the the user cannot access thisinformation

[1465]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1466] 1.1.20.21 removeValidValue

[1467] public void removeValidValue(java.lang.Object value)

[1468] throws AuthorizationException

[1469] Removes a valid value for this Field definition. If the value wasthe last one, then any value respecting the basic constraints Willbcacceptale.

[1470] Parameters:

[1471] value—the valid value to remove from the Set.

[1472] Throws:

[1473]AuthorizationException—if the the user cannot access thisinformation

[1474] 1.1.20.22 getDefaultValue

[1475] public java.lang.Object getDefaultValue ( )

[1476] throws AuthorizationException, ConnectionException

[1477] Provides the default value for this Field definition.

[1478] Returns:

[1479] the default value for the field, possibly null

[1480] Throws:

[1481]AuthorizationException—if the current user does not havepermission to perform this operation

[1482]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1483] 1.1.20.23 setDefaultValue

[1484] public void setDefaultvalue(java.lang.Object value)

[1485] throws AuthorizationException

[1486] Sets the default value for this Field definition.

[1487] Parameters:

[1488] value—the new default value

[1489] Throws:

[1490]AuthorizationException—if the current user does not havepermission to perform this operation

[1491] 1.1.20.24 getPage

[1492] public int getpage ( )

[1493] throws AuthorizationException, ConnectionException

[1494] Provides the page number of the field, used for display purposes.If it cannot be determined, a 0 is returned.

[1495] Returns:

[1496] the page number of the field, 0 if it cannot be determined

[1497] Throws:

[1498]AuthorizationException—if the current user does not havepermission to perform this operation

[1499]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1500] 1.1.20.25 getorder

[1501] public int getOrder ( )

[1502] throws AuthorizationException, ConnectionException

[1503] Provides the order of the field.

[1504] Returns:

[1505] the order of the field

[1506] Throws:

[1507]AuthorizationException—if the current user does not havepermission to perform this operation

[1508]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1509] 1.1.20.26 getPageDescription

[1510] public java.lang.String getPageDescription ( )

[1511] throws AuthorizationException, ConnectionException

[1512] Provides the name of the page the field is on.

[1513] Returns:

[1514] the name of the page

[1515] Throws:

[1516]AuthorizationException—if the current user does not havepermission to perform this operation

[1517]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1518] 1.1.20.27 getHelpText

[1519] public java.lang.String getHelpText ( )

[1520] throws AuthorizationException, ConnectionException

[1521] Provides the help text for the field, if available.

[1522] Returns:

[1523] the help text for the field

[1524] Throws:

[1525]AuthorizationException—if the current user does not havepermission to perform this operation

[1526]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

1.1.21 INTERFACE INDEX

[1527] All Superinterfaces:

[1528] ObjectWithPrimaryKey

[1529] public interface Index

[1530] extends ObjectWithPrimaryKey

[1531] An Index represents a categorization tool used on a branch.Method Summary java.lang.String getDefaultValue( ) Provides the defaultvalue of this index. java.lang.String getName( ) Provides the name ofthe index. java.util.Set getValidValues( ) Provides the valid values ofthis index. boolean isMultiple( ) Indicates whether the index allowsmultiple values to be selected.

[1532] Methods inherited from interfacecom.conceptis.cms.ObjectWithPrimaryKey

[1533] getprimaryKey

Method Detail

[1534] 1.1.21.1 getName

[1535] public java.lang.String getName ( )

[1536] throws ConnectionException, AuthorizationException

[1537] Provides the name of the index.

[1538] Returns:

[1539] the name of the index

[1540] Throws:

[1541]AuthorizationException—if the current user does not havepermission to perform this operation

[1542]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1543] 1.1.21.2 getValidValues

[1544] public java.util.Set getValidValues ( )

[1545] throws ConnectionException, AuthorizationException

[1546] Provides the valid values of this index.

[1547] Returns:

[1548] the valid values of this index (a set containing Qtrnns)

[1549] Throws:

[1550]AuthorizationException—if the current user does not havepermission to perform this operation

[1551]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1552] 1.1.21.3 getDefaultValue

[1553] public java.lang.String getDefaultValue ( )

[1554] throws ConnectionException, AuthorizationException

[1555] Provides the default value of this index.

[1556] Returns:

[1557] the default value of this index

[1558] Throws:

[1559]AuthorizationException—if the current user does not havepermission to perform this operation

[1560]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1561] 1.1.21.4 isMultiple

[1562] public boolean isMultiple ( )

[1563] throws ConnectionException, AuthorizationException

[1564] Indicates whether the index allows multiple values to beselected.

[1565] Returns:

[1566] true if multiple values are allowed, false otherwise

[1567] Throws:

[1568]AuthorizationException—if the current user does not havepermission to perform this operation

[1569]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

1.1.22 INTERFACE INDEXFACTORY

[1570] public interface IndexFactory

[1571] Interacts with the CMS to provide access indices of the CMS.Method Summary Index getIndex(com.conceptis.util.PrimaryKey key)Provides the index for the specified key. java.util.Set getIndices(Itemitem) Provides the indices available for a branch.

Method Detail

[1572] 1.1.22.1 getIndex

[1573] public Index getIndex(com.conceptis.util.PrimaryKey key)

[1574] throws ConnectionException, AuthorizationException,MissingResourceException

[1575] Provides the index for the specified key.

[1576] Parameters:

[1577] key—the primary key of the index

[1578] Returns:

[1579] the index with the primary key

[1580] Throws:

[1581]ConnectionException—if there is a problem interacting with the CMS

[1582]AuthorizationException—if the current user does not havepermission to perform this operation

[1583]MissingResourceException—if the user specified by the key does notexist

[1584] 1.1.22.2 getIndices

[1585] public java.util.Set getIndices(Item item)

[1586] throws ConnectionException, AuthorizationException,MissingResourceException

[1587] Provides the indices available for a branch.

[1588] Parameters:

[1589] item—the branch to find the indices for

[1590] Returns:

[1591] the indices available for a branch (a set of Index objects); maybe empty but not null

[1592] Throws:

[1593]ConnectionException—if there is a problem interacting with the CMS

[1594]AuthorizationException—if the current user does not havepermission to perform this operation

[1595]MissingResourceException—if the user specified by the key does notexist

1.1.23 INTERFACE ITEM

[1596] All Superinterfaces:

[1597] ObjectWithPrimaryKey

[1598] public interface Item

[1599] extends ObjectWithPrimaryKey

[1600] An Item is the most basic piece of data found in the ContentManagement System (CMS). Method Summary boolean addIndexValue(Indexindex, java.lang.String value) Adds an index value. voidaddRelatedItem(RelationType relationType, Item relatedItem,java.util.Map parameters) Links an Item to this one, using the givenRelationType to define the link itself. voidaddSupportedLocale(java.util.Locale locale) Mark the specified Locale assupported for this item. void addThesaurusTerm(int level,java.lang.String term) Indexes the item in a thesaurus. BinaryContentgetBinaryContent( ) Provides the binary content stored in the Item.Collection getCollection( ) Returns the Collection to which this Itembelongs. java.lang.String getComment( ) Returns the comment associatedwith this Item. java.util.Locale getDefaultLocale( ) Provides the item'sdefault Locale. java.lang.Object getFieldValue(Field field) Returns thevalue of the Field. java.lang.Object getFieldValue(java.lang.Stringname) Returns the value of the Field identified by the given name.java.util.Set getIndexValues(Index index) Provides the index values seton the item. java.util.Set getIndices( ) Provides the indices availablefor this item. ItemType getItemType( ) Returns the <CODEITEMTYPE<code>of this Item. java.util.Date getLastModifiedDate( ) Provides thelast modified date. java.lang.String getLocalizedValue(java.util.Localelocale) Returns the value for the specified Locale. java.lang.StringgetName( ) Returns the name of this Item. PublicationStatusgetPublicationStatus( ) Returns the PublicationStatus of this Item.java.util.Set getRelatedItems(ItemType itemType) Returns a Set of ItemSrelated to this Item and that all share the same ItemType. java.util.SetgetRelatedItems(RelationType relationType) Returns a Set of ItemSrelated to this Item by the given RelationType. java.util.SetgetRelatedItems(RelationType relationType, ItemType itemType) Returns aSet of ItemS related to this Item by the given RelationType and that allshare the same ItemType. java.util.Set getRelationType(Item relatedItem)Returns the Set of RelationTypes that exist between this Item and thespecified Item. java.util.Set getRelationTypes( ) Provides theRelationTypes that this object is participating in. java.lang.StringgetShortName( ) Returns the short name associated with this Item.java.util.Date getSignOffDate( ) Returns the DateItem to which thisPublicationStatus was assigned can be signed off automatically.java.util.List getSupportedLocales( ) Provides the LocaleS supported forthis item. com.conceptis.util.Tree getThesaurusTerms( ) Get thethesaurus terms associated to the item. java.util.List getVersions( )Returns the List of VersionS associated to this Item. boolean isLocked() Returns true if this Item is locked for editing; false otherwise. voidreject( ) Rejects the Item to the previous publication status. voidreject(java.lang.String message) Rejects the Item to the previouspublication status, with a message. void removeAllThesaurusTerms( )Removes all thesaurus terms from the indexation of the item booleanremoveIndexValue(Index index, java.lang.String value) Removes and indexvalue. void removeRelatedItem(RelationType relationType, ItemrelatedItem) Removes the link between the given Item and this one, thelink being defined by the given RelationType. voidremoveSupportedLocale(java.util.Locale locale) Unmark the Locale asbeing supported for this item. void removeThesaurusTerm(java.lang.Stringterm) Removes a thesaurus term from the indexation of the item voidsetBinaryContent(java.lang.String mimeType, java.io.InputStreaminputStream, byte[] termination) Sets the binary content stored in theItem. void setBinaryContent(java.lang.String mimeType,java.io.InputStream inputStream, long length) Sets the binary contentstored in the Item. void setCollection(Collection collection) Sets theCollection to which this Item belongs. void setComment(java.lang.Stringcomment) Sets the comment associated with this Item. voidsetDefaultLocale(java.util.Locale locale) Set the item's default Locale.void setFieldValue(Field field, java.lang.Object value) Sets the valueof a Field to the given Object. void setFieldValue(java.lang.Stringname, java.lang.Object value) Sets the value of a field, identified byits name, to the given Object. void setLocalizedValue(java.util.Localelocale, java.lang.String value) Set the localized value for thespecified Locale. void setName(java.lang.String name) Sets the name ofthis Item. void setShortName(java.lang.String shortName) Sets the shortname associated with this Item. void setSignOffDate(java.util.Date date)Sets the DateItem to which this PublicationStatus was assigned can besigned off automatically. void signoff( ) Signs off the Item to the nextpublication status. void signoff(java.lang.String message) Signs off theItem to the next publication status, with a message.

[1601] Methods inherited from interfacecom.conceptis.cms.ObjectWithPrimaryKey

[1602] getPrimaryKey

Method Detail

[1603] 1.1.23.1 getItemType

[1604] public ItemTypegetItemType ( )

[1605] throws AuthorizationException ConnectionException,MissingResourceException

[1606] Returns the <CODEITEMTYPE<code>of this Item.

[1607] Returns:

[1608] the ItemType of this Item

[1609] Throws:

[1610]AuthorizationException—if the current user does not havepermission to perform this operation

[1611]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1612]MissingResourceException—if the type does not exist

[1613] 1.1.23.2 setName

[1614] public void setName(java.lang.String name)

[1615] throws AuthorizationException, ConnectionException,java.lang.IllegalStateException

[1616] Sets the name of this Item.

[1617] Parameters:

[1618] name—the name of this Item

[1619] Throws:

[1620]AuthorizationException—if the current user does not havepermission to perform this operation

[1621]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1622] java.lang.IllegalStateException—if this Item was not locked forediting when retrieved.

[1623] 1.1.23.3 getName

[1624] public java.lang.String getName ( )

[1625] throws AuthorizationException, ConnectionException

[1626] Returns the name of this Item.

[1627] Returns:

[1628] the name of this Item

[1629] Throws:

[1630]AuthorizationException—if the current user does not havepermission to perform this operation

[1631]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1632] 1.1.23.4 setShortName

[1633] public void setShortName(java.lang.String shortname)

[1634] throws AuthorizationException, ConnectionException,java.lang.IllegalStateException

[1635] Sets the short name associated with this Item.

[1636] Parameters:

[1637] shortName—the short name associated with this Item

[1638] Throws:

[1639]AuthorizationException—if the current user does not havepermission to perform this operation

[1640]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1641] java.lang.IllegalStateException—if this Item was not locked forediting when retrieved.

[1642] 1.1.23.5 getShortName

[1643] public java.lang.String getShortName ( )

[1644] throws AuthorizationException, ConnectionException

[1645] Returns the short name associated with this Item.

[1646] Returns:

[1647] the short name associated with this Item

[1648] Throws:

[1649]AuthorizationException—if the current user does not havepermission to perform this operation

[1650]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1651] 1.1.23.6 setCollection

[1652] public void setCollection(Collection collection)

[1653] throws AuthorizationException, ConnectionException,java.lang.IllegalStateException

[1654] Sets the Collection to which this Item belongs.

[1655] Parameters:

[1656] collection—the Collection to which this Item belongs

[1657] Throws:

[1658]AuthorizationException—if the current user does not havepermission to perform this operation

[1659]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1660] java.lang.IllegalStateException—if this Item was not locked forediting when retrieved.

[1661] 1.1.23.7 getCollection

[1662] public Collection getCollection ( )

[1663] throws AuthorizationException, ConnectionException,MissingResourceException

[1664] Returns the Collection to which this Item belongs.

[1665] Returns:

[1666] the Collection to which this Item belongs

[1667] Throws:

[1668]AuthorizationException—if the current user does not havepermission to perform this operation

[1669]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1670]MissingResourceException—if the collection does not exist

[1671] 1.1.23.8 setComment

[1672] public void setComment(java.lang.String comment)

[1673] throws AuthorizationException, ConnectionException,java.lang.IllegalStateException

[1674] Sets the comment associated with this Item.

[1675] Parameters:

[1676] comment—the comment associated with this Item

[1677] Throws:

[1678]AuthorizationException—if the current user does not havepermission to perform this operation

[1679]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1680] java.lang.IllegalStateException—if this Item was not locked forediting when retrieved.

[1681] 1.1.23.9 getComment

[1682] public java.lang.String getComment ( )

[1683] throws AuthorizationException, ConnectionException

[1684] Returns the comment associated with this Item.

[1685] Returns:

[1686] the comment associated with this Item

[1687] Throws:

[1688]AuthorizationException—if the current user does not havepermission to perform this operation

[1689]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1690] 1.1.23.10 setFieldValue

[1691] public void setFieldValue(java.lang.String name, java.lang.objectvalue)

[1692] throws AuthorizationException, ConnectionException,java.lang.IllegalArgumentException, java.lang.IllegalStateException,MissingResourceException

[1693] Sets the value of a field, identified by its name, to the givenObject.

[1694] Parameters:

[1695] name—the name of the field

[1696] value—the value of the field, which can be any Object

[1697] Throws:

[1698]AuthorizationException—if the current user does not havepermission to perform this operation

[1699]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1700] java.lang.IllegalArgumentException—if the value is not acceptablefor the corresponding Field

[1701] java.lang.IllegalStateException—if this Item was not locked forediting when retrieved.

[1702]MissingResourceException—if the item type does not exist

[1703] 1.1.23.11 getFieldValue

[1704] public java.lang.Object getFieldValue(java.lang.String name)

[1705] throws AuthorizationException, ConnectionException,java.lang.IllegalArgumentException, MissingResourceException

[1706] Returns the value of the Field identified by the given name. Ifthe corresponding Field does not have a value set, this method willreturn null. If the specified Field cannot be found, this method willthrow an IllegalArgumentException.

[1707] Parameters:

[1708] name—the name of the Field

[1709] Returns:

[1710] the value of the Field, which can be any object; null if no valuehas been set

[1711] Throws:

[1712]AuthorizationException—if the current user does not havepermission to perform this operation

[1713]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1714] java.lang.IllegalArgumentException—if no Field can be found forthe specified name

[1715]MissingResourceException—if the item type does not exist

[1716] 1.1.23.12 setFieldValue

[1717] public void setFieldValue(Field field, java.lang.Object value)

[1718] throws AuthorizationException, ConnectionException,java.lang.IllegalArgumentException, java.lang.IllegalStateException,MissingResourceException

[1719] Sets the value of a Field to the given Object.

[1720] Parameters:

[1721] field—the Field

[1722] value—the value of the field, which can be any Object

[1723] Throws:

[1724]AuthorizationException—if the current user does not havepermission to perform this operation

[1725]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1726] java.lang.IllegalArgumentException—if the value is not acceptablefor the corresponding Field

[1727] java.lang.IllegalStateException—if this Item was not locked forediting when retrieved.

[1728]MissingResourceException—if the item type does not exist

[1729] 1.1.23.13 getFieldValue

[1730] public java.lang.Object getFieldValue(Field field)

[1731] throws AuthorizationException, ConnectionException,java.lang.IllegalArgumentException, MissingResourceException

[1732] Returns the value of the Field. If the corresponding Field doesnot have a value set, this method will return null. If the specifiedField cannot be found, this method will throw anIllegalArgumentException.

[1733] Parameters:

[1734] field—the Field

[1735] Returns:

[1736] the value of the Field, which can be any Object; null if no valuehas been set

[1737] Throws:

[1738]AuthorizationException—if the current user does not havepermission to perform this operation

[1739]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1740] java.lang.IllegalArgumentException—if no Field can be found forthe specified name

[1741]MissingResourceException—if the item type does not exist

[1742] 1.1.23.14 getPublicationStatus

[1743] public PublicationStatusgetPublicationStatus ( )

[1744] throws AuthorizationException, MissingResourceException

[1745] Returns the PublicationStatus of this Item.

[1746] Returns:

[1747] the PublicationStatus of this Item

[1748] Throws:

[1749]AuthorizationException—if the current user does not havepermission to perform this operation

[1750]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1751]MissingResourceException—if the status does not exist

[1752] 1.1.23.15 getVersions

[1753] public java.util.List getVersions ( )

[1754] throws AuthorizationException, ConnectionException

[1755] Returns the List of versions associated to this Item.

[1756] Returns:

[1757] the List of Versions associated to this Item

[1758] Throws:

[1759]AuthorizationException—if the current user does not havepermission to perform this operation

[1760]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1761] 1.1.23.16 getBinaryContent

[1762] public BinaryContent getBinaryContent ( )

[1763] throws AuthorizationException, MissingResourceException,ConnectionException

[1764] Provides the binary content stored in the Item. If there is nobinary content in this item, it will return null.

[1765] Returns:

[1766] the binary content in the item, null if there is no binarycontent

[1767] Throws:

[1768]AuthorizationException—if the current user does not havepermission to perform this operation

[1769]MissingResourceException—if the item does not exist

[1770]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1771] 1.1.23.17 setBinaryContent

[1772] public void setBinaryContent(java.lang.String mimeType,java.io.InputStream inputStream, long length)

[1773] throws AuthorizationException, ConnectionException,MissingResourceException, java.io.IOException,java.lang.IllegalStateException

[1774] Sets the binary content stored in the Item. The binary contentcan be set to null. Note: unlike most set methods, the implementation ofthis method will immediatly send the data to the repository. Therefore,the Item must be locked for editing before a call to this method ismade. After the method returns, the lock on the item is released andmust be obtained again.

[1775] Parameters:

[1776] mimeType—the MIME type of this binary content

[1777] inputstream—the InputStream that contains the data of the Item

[1778] length—the length of the content

[1779] Throws:

[1780]AuthorizationException—if the current user does not havepermission to perform this operation

[1781]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1782] java.io.IOException—if an error occurs while accessing theInputStream

[1783] java.lang.IllegalStateException—if this Item was not locked forediting when retrieved.

[1784]MissingResourceException—if the item does not exist

[1785] 1.1.23.18 setBinaryContent

[1786] public void setBinaryContent(java.lang.String mimeType,java.io.InputStream inputstream, byte[] termination)

[1787] throws AuthorizationException, ConnectionException,MissingResourceException, java.io.IOException,java.lang.IllegalStateException

[1788] Sets the binary content stored in the Item. The binary contentcan be set to null. Authorization required: Action.UPDATE on the itemNote: unlike most set methods, the implementation of this method willimmediatly send the data to the repository. Therefore, the Item must belocked for editing before a call to this method is made. After themethod returns, the lock on the item is released.

[1789] Parameters:

[1790] mimeType—the MIME type of this binary content

[1791] inputstream—the Inputstream that contains the data of the Item

[1792] termination—the termination pattern

[1793] Throws:

[1794]AuthorizationException—if the current user does not havepermission to perform this operation

[1795]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1796] java.io.IOException—if an error occurs while accessing theInputStream

[1797] java.lang.IllegalStateException—if this Item was not locked forediting when retrieved.

[1798]MissingResourceException—if the item does not exist

[1799] 1.1.23.19 signoff ( )

[1800] public void signoff ( )

[1801] throws AuthorizationException, ConnectionException,java.lang.IllegalStateException, MissingResourceException

[1802] Signs off the Item to the next publication status.

[1803] Throws:

[1804]AuthorizationException—if the current user does not havepermission to perform this operation

[1805]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1806] java.lang.IllegalStateException—if this Item is in it's finalpublication status

[1807]MissingResourceException—if the status does not exist

[1808] 1.1.23.20 signoff

[1809] public void signoff(java.lang.string message)

[1810] throws AuthorizationException, ConnectionException,java.lang.IllegalStateException, MissingResourceException

[1811] Signs off the Item to the next publication status, with amessage.

[1812] Parameters:

[1813] message—a note to associate with the signing off

[1814] Throws:

[1815]AuthorizationException—if the current user does not havepermission to perform this operation

[1816]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1817] java.lang.IllegalStateException—if this Item is in it's finalpublication status

[1818]MissingResourceException—if the status does not exist

[1819] 1.1.23.21 reject

[1820] public void rejects ( )

[1821] throws AuthorizationException, ConnectionException,java.lang.IllegalStateException, MissingResourceException

[1822] Rejects the Item to the previous publication status.

[1823] Throws:

[1824]AuthorizationException—if the current user does not havepermission to perform this operation

[1825]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1826] java.lang.IllegalStateException—if this Item is in it's finalpublication status

[1827]MissingResourceException—if the status does not exist

[1828] 1.1.23.22 reject

[1829] public void reject(java.lang.String message)

[1830] throws AuthorizationException, ConnectionException,java.lang.IllegalStateException, MissingResourceException

[1831] Rejects the Item to the previous publication status, with amessage.

[1832] Parameters:

[1833] message—a note to associate with the signing off

[1834] Throws:

[1835]AuthorizationException—if the current user does not havepermission to perform this operation

[1836]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1837] java.lang.IllegalStateException—if this Item is in it's finalpublication status

[1838]MissingResourceException—if the status does not exist

[1839] 1.1.23.23 addRelateditem

[1840] public void addRelatedItem(RelationType relationType, Itemrelateditem, java.util.Map parameters)

[1841] throws AuthorizationException, ConnectionException,java.lang.IllegalStateException

[1842] Links an Item to this one, using the given RelationType to definethe link itself. The relation type works like this: if you want to add aparent Item to this Item, you would callthefollowing:this.addRelatedItem(RelationType.PARENT, parentItem);.

[1843] Parameters:

[1844] relationType—the RelationType that characterizes the link betweenthis Item and the other.

[1845] relateditem—the Item to link to this Item

[1846] parameters—any parameters to apply to the relationship

[1847] Throws:

[1848]AuthorizationException—if the current user does not havepermission to perform this operation

[1849]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1850] java. lang. IllegalStateException—if the specified RelationTypealready defines

[1851] a unique linked Item; or if trying to save an Item that was notlocked for editing when retrieved.

[1852] 1.1.23.24 getRelateditems

[1853] public java.util.Set getRelateditems(RelationType relationType)

[1854] throws AuthorizationException, ConnectionException

[1855] Returns a Set of Items related to this Item by the givenRelationType. The Set may be empty, but never null.

[1856] Parameters:

[1857] relationType—the RelationType that characterizes the link betweenthis Item and the others.

[1858] Returns:

[1859] Set of Items related to this one by the given RelationType

[1860] Throws:

[1861]AuthorizationException—if the current user does not havepermission to perform this operation

[1862]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1863] 1.1.23.25 getRelateditems

[1864] public java.util.Set getRelatedItems(ItemType itemType)

[1865] throws AuthorizationException, ConnectionException

[1866] Returns a Set of Items related to this Item and that all sharethe same ItemType. The Set may be empty, but never null.

[1867] Parameters:

[1868] itemType—the ItemType shared by all the related Items in thereturned Set.

[1869] Returns:

[1870] Set of ItemS related to this one and that al share the givenItemType

[1871] Throws:

[1872]AuthorizationException—if the current user does not havepermission to perform this operation

[1873]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1874] 1.1.23.26 getRelateditems

[1875] public java.util.Set getRelatedItems(RelationType relationType,ItemType itemType)

[1876] throws AuthorizationException, ConnectionException

[1877] Returns a Set of Items related to this Item by the givenRelationType and that all share the same ItemType. The Set maybe empty,but never null.

[1878] Parameters:

[1879] relationType—the RelationType that characterizes the link betweenthis Item and the others.

[1880] itemType—the ItemType shared by all the related Items in thereturned Set.

[1881] Returns:

[1882] Set of Items related to this one and that al share the givenItemType

[1883] Throws:

[1884]AuthorizationException—if the current user does not havepermission to perform tnis operation

[1885]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1886] 1.1.23.27 getRelationType

[1887] public java.util.Set getRelationType(Item relateditem)

[1888] throws AuthorizationException, ConnectionException

[1889] Returns the Set of RelationTypes that exist between this Item andthe specified Item.

[1890] The returned Set may be empty (no relation between the two), butnever null.

[1891] Parameters:

[1892] relateditem—the Item that may be related to this one by one ormore RelationTypeS

[1893] Returns:

[1894] Set of RelationType defined between this Item and the specifiedItem

[1895] Throws:

[1896]AuthorizationException—if the current user does not havepermission to perform this operation

[1897]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1898] 1.1.23.28 removeRelateditem

[1899] public void removeRelatedItem(RelationType relationType, Itemrelateditem)

[1900] throws AuthorizationException, ConnectionException,java.lang.IllegalStateException

[1901] Removes the link between the given Item and this one, the linkbeing defined by the given RelationType. The relation type works likethis: if you want to remove a child Item from this Item, you would callthe following:

[1902] this.removeRelatedItem(RelationType.CHILD, childItem);.

[1903] Parameters:

[1904] relationType—the RelationType that characterizes the link betweenthis Item and the other.

[1905] relateditem—the Item to unlink from this Item

[1906] Throws:

[1907]AuthorizationException—if the current user does not havepermission to perform this operation ConnectionException—if there is aproblem interacting with the CMS; this will only be thrown if the driverimplementation choses to use deferred data loading (for performancereason).

[1908] java.lang. IllegalStateException—if this Item was not locked forediting when retrieved.

[1909] 1.1.23.29 getRelationTypes

[1910] public java.util.Set getRelationTypes ( )

[1911] throws AuthorizationException, ConnectionException,java.lang.IllegalStateException

[1912] Provides the RelationTypeS that this object is participating in.

[1913] Returns:

[1914] a Set of relation types that this item is in

[1915] Throws:

[1916]AuthorizationException—if the current user does not havepermission to perform this operation

[1917]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1918] java.lang.IllegalStateException—if this Item was not locked forediting when retrieved.

[1919] 1.1.23.30 isLocked

[1920] public boolean isLocked ( )

[1921] throws AuthorizationException, ConnectionException

[1922] Returns true if this Item is locked for editing; false otherwise.

[1923] Returns:

[1924] true if this Item is locked for editing; false otherwise.

[1925] Throws:

[1926]AuthorizationException—if the current user does not havepermission to perform this operation

[1927]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1928] 1.1.23.31 getSignOffDate

[1929] public java.util.Date getSignOffDate ( )

[1930] throws AuthorizationException, ConnectionException

[1931] Returns the DateItem to which this PublicationStatus was assignedcan be signed off automatically. This only applies to aPublicationStatus that has been set to #SIGN_OFF_AUTOMATICALLY_AT.

[1932] Returns:

[1933] the Date to reach before the Item to which this PublicationStatuswas assigned can be signed off automatically

[1934] Throws:

[1935]AuthorizationException—if the current user does not havepermission to perform this operation

[1936]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1937] 1.1.23.32 setSignOffDate

[1938] public void setsignoftDate(java.util.Date date)

[1939] throws AuthorizationException, ConnectionException

[1940] Sets the DateItem to which this PublicationStatus was assignedcan be signed off automatically. This only applies to aPublicationStatus that has been set to #SIGN_OFF_AUTOMATICALLY-AT.

[1941] Parameters:

[1942] date—the Date to reach before the Item to which thisPublicationStatus was assigned can be signed off automatically

[1943] Throws:

[1944]AuthorizationException—if the current user does not havepermission to perform this operation

[1945]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1946] 1.1.23.33 addThesaurusTerm

[1947] public void addThesaurusTerm(int level, java.lang.String term)

[1948] throws AuthorizationException, ConnectionException

[1949] Indexes the item in a thesaurus.

[1950] Parameters:

[1951] level—the level, I for primary term, 2 for secondary term, etc.

[1952] term—the term The thesaurus term to index the item with. Must bepart of the thesaurus

[1953] Throws:

[1954]AuthorizationException—if the current user does not havepermission to perform this operation

[1955]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1956] 1.1.23.34 removeThesaurusTerm

[1957] public void removeThesaurusTerm(java.lang.String term)

[1958] throws AuthorizationException, ConnectionException

[1959] Removes a thesaurus term from the indexation of the item

[1960] Parameters:

[1961] term—the term The thesaurus term to index the item with. Must bepart of the thesaurus

[1962] Throws:

[1963]AuthorizationException—if the current user does not havepermission to perform this operation

[1964]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1965] 1.1.23.35 removeAllThesaurusTerms

[1966] public void removeAllThesaurusTerms ( )

[1967] throws AuthorizationException, ConnectionException

[1968] Removes all thesaurus terms from the indexation of the item

[1969] Throws:

[1970]AuthorizationException—if the current user does not havepermission to perform this operation

[1971]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1972] 1.1.23.36 getThesaurusTerms

[1973] public com.conceptis.util.Tree getThesaurusTerms ( )

[1974] throws AuthorizationException, ConnectionException

[1975] Get the thesaurus terms associated to the item. Item at the firstlevel are primary terms, at the second level are secondary term and soon.

[1976] Returns:

[1977] com.conceptis.util.Tree the tree of thesaurus term associatedwith the item

[1978] Throws:

[1979]AuthorizationException—if the current user does not havepermission to perform this operation

[1980]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[1981] 1.1.23.37 setDefaultLocale

[1982] public void setDefaultLocale(java.util.Locale locale)

[1983] throws ConnectionException, AuthorizationException

[1984] Set the item's default Locale. An Item cannot be saved unless thelocalized value for the default Locale is completed. (Other supportedLocales pose no such restrictions) This information is persisted in theitem using XML.

[1985] Parameters:

[1986] locale—The Locale that this object *must* support in order to bepersisted in the CMS. May be null (in which case no locale is required).

[1987] Throws:

[1988]ConnectionException—if there is a problem interacting with the CMS

[1989]AuthorizationException—if the current user does not havepermission to perform this operation

[1990] 1.1.23.38 getDefaultLocale

[1991] public java.util.Locale getDefaultLocale ( )

[1992] throws ConnectionException, AuthorizationException

[1993] Provides the item's default Locale. An Item cannot be savedunless the localized value for the default Locale is completed. (Othersupported Locales pose no such restrictions) This information ispersisted in the item using.

[1994] Returns:

[1995] the default locale

[1996] Throws:

[1997]ConnectionException—if there is a problem interacting with the CMS

[1998]AuthorizationException—if the current user does not havepermission to perform this operation

[1999] 1.1.23.39 getLocalizedValue

[2000] public java.lang.String getLocalizedValue(java.util.Localelocale)

[2001] throws ConnectionException, AuthorizationException,java.lang.IllegalArgumentException

[2002] Returns the value for the specified Locale. If is not part of theitem's supported Locales, an IllegalArgumentException is thrown.

[2003] Parameters:

[2004] locale—The Locale for the accompanying value.

[2005] Returns:

[2006] The String of the localized value.

[2007] Throws:

[2008]ConnectionException—if there is a problem interacting with the CMS

[2009]AuthorizationException—if the current user does not havepermission to perform this operation

[2010] java.lang.IllegalArgumentException—if the specified Locale is notsupported by this item.

[2011] 1.1.23.40 setLocalizedValue

[2012] public void setLocalizedValue(java.util.Locale locale,java.lang.String value)

[2013] throws ConnectionException AuthorizationException,java.lang.IllegalArgumentException

[2014] Set the localized value for the specified Locale.

[2015] Parameters:

[2016] locale—The Locale for the accompanying value.

[2017] value—The String of the localized value.

[2018] Throws:

[2019]ConnectionException—if there is a problem interacting with the CMS

[2020]AuthorizationException—if the current user does not havepermission to perform this operation

[2021] java. lang. IllegalArgumentException—if the specified Locale isnot supported by this item.

[2022] 1.1.23.41 addSupportedLocale public voidaddSupportedLocale(java.util.Locale locale)

[2023] throws ConnectionException, AuthorizationException,java.lang.IllegalStateException

[2024] Mark the snerifpid TLoale as supported for this item. (Thisinformation is stored in the xmlLocaleString field). Having no valuesfor these locales will *not* prevent the item from being saved to theCMS, however business logic *IS* expected to prevent the items fromhaving their publishing states set anything that may be viewable!!!

[2025] Parameters:

[2026] locale—The Locale to support.

[2027] Throws:

[2028]ConnectionException—if there is a problem interacting with the CMS

[2029]AuthorizationException—if the current user does not havepermission to perform this operation

[2030] java. lang. IllegalstateException—if the specified Locale isalready listed as being supported. (either as a default *or* supportedlocale)

[2031] 1.1.23.42 removeSupportedLocale

[2032] public void removesupportedLocale(java.util.Locale locale)

[2033] throws ConnectionException, AuthorizationException,java.lang.IllegalStateException

[2034] Unmark the Locale as being supported for this item. (Thisinformation is stored in the xmlLocaleString field). Localized valuesalready set will not be deleted, however, they will no longer bevisible/editable unless the Locale is once again marked as beingsupported.

[2035] Parameters:

[2036] locale—The Locale to no longer support.

[2037] Throws:

[2038]ConnectionException—if there is a problem interacting with the CMS

[2039]AuthorizationException—if the current user does not havepermission to perform this operation

[2040] java. lang. IllegalStateException—if the specified Locale is notlisted as being supported. (either as a default *or* supported locale)

[2041] 1.1.23.43 getSupportedLocales

[2042] public java.util.List getSupportedLocales ( )

[2043] throws ConnectionException, AuthorizationException,java.lang.IllegalStateException

[2044] Provides the Locales supported for this item. (This informationis stored in the xmlLocaleString field).

[2045] Returns:

[2046] a list of Locale objects

[2047] Throws:

[2048]ConnectionException—if there is a problem interacting with the CMS

[2049]AuthorizationException—if the current user does not havepermission to perform this operation

[2050] java.lang.IllegalStateException—if the specified Locale is notlisted as being supported. (either as a default *or* supported locale)

[2051] 1.1.23.44 getLastModifiedDate

[2052] public java.util.Date getLastModifiedDate ( )

[2053] throws ConnectionException, AuthorizationExceptionProvides thelast modified date.

[2054] Returns:

[2055] the date the item was last modified.

[2056] Throws:

[2057]ConnectionException—if there is a problem interacting with the CMS

[2058]AuthorizationException—if the current user does not havepermission to perform this operation

[2059] 1.1.23.45 getindexValues

[2060] public java.util.Set getIndexValues(Index index)

[2061] throws AuthorizationException, ConnectionException

[2062] Provides the index values set on the item.

[2063] Parameters:

[2064] index—the index

[2065] Returns:

[2066] the values on the index

[2067] Throws:

[2068]ConnectionException—if there is a problem interacting with the CMS

[2069]AuthorizationException—if the current user does not havepermission to perform this operation

[2070] 1.1.23.46 addIndexValue

[2071] public boolean addIndexvalue(Indexindex, java.lang.String value)

[2072] throws AuthorizationException, ConnectionException

[2073] Adds an index value.

[2074] Parameters:

[2075] index—the index

[2076] value—the value of the index

[2077] Returns:

[2078] true if the set of index values changed as a result of thisoperation

[2079] Throws:

[2080]ConnectionException—if there is a problem interacting with the CMS

[2081]AuthorizationException—if the current user does not havepermission to perform this operation

[2082] 1.1.23.47 removeIndexValue

[2083] public boolean removeIndexValue(Indexindex, java.lang.Stringvalue)

[2084] throws AuthorizationException, ConnectionException

[2085] Removes and index value.

[2086] Parameters:

[2087] index—the index

[2088] value—the value of the index

[2089] Returns:

[2090] true if the set of index values changed as a result of thisoperation

[2091] Throws:

[2092]ConnectionException—if there is a problem interacting with the CMS

[2093]AuthorizationException—if the current user does not havepermnission to perform this operation

[2094] 1.1.23.48 getIndices

[2095] public java.util.Set getIndices ( )

[2096] throws ConnectionException, AuthorizationException,MissingResourceException

[2097] Provides the indices available for this item.

[2098] Returns:

[2099] the indices available for a branch (a set of Index objects); maybe empty but not null

[2100] Throws:

[2101]ConnectionException—if there is a problem interacting with the CMS

[2102]AuthorizationException—if the current user does not havepermission to perform this operation

[2103]MissingResourceException—if the user specified by the key does notexist

1.1.24 INTERFACE ITEMFACTORY

[2104] public interface ItemFactory

[2105] Interacts with the CMS to provide access to items of the CMS.Method Summary void addRootItem(Item root) Sets the root Item of thesite. Item createNewItem(ItemType itemType) Creates a new Item instance,uninitialized, not stored in the CMS. void deleteItem(Item item) Deletesthis Item. Item getItem(com.conceptis.util.PrimaryKey key, booleanlockForEditing) Provides the Item with the specified key. ItemgetItem(java.lang.String identifier, boolean lockForEditing) Providesthe Item with the specified identifier. Item getItem(java.net.URLidentifier, boolean lockForEditing) Provides the Item with the specifiedURL. java.util.Set getItems( ) Provides the set of all ItemS.java.util.Set getItems(ItemType itemType) Returns a Set of Item that allshare the same ItemType. java.util.Set getItems(ItemType itemType, Itemtop) Returns a set of Item that all share the same ItemType and areunder the same Item. java.util.Set getRootItems( ) Provides the rootItemS of the site. void lockItem(Item item) Unlocks the specified Itemwithout saving any changes, therefore making it available for editing tosomeone else. void removeRootItem(Item root) Sets the root Item of thesite. void saveItem(Item item) Saves the specified Item.com.conceptis.util.PagedList search(ItemSearchConstraints constraints)Searches for ItemS matching the constraints. java.util.SetsearchForItem(ItemSearchConstraints constraints) Deprecated. usesearch(com.conceptis.cms.ItemSearchConstraints), which returns a pagedlist void unlockItem(Item item) Unlocks the specified Item withoutsaving any changes, therefore making it available for editing to someoneelse.

Method Detail

[2106] 1.1.24.1 getItems

[2107] public java.util.Set getitems ( )

[2108] throws ConnectionException, AuthorizationException

[2109] Provides the set of all ItemS.

[2110] Returns:

[2111] the set of all ItemS (may be empty but never null)

[2112] Throws:

[2113]ConnectionException—if there is a problem interacting with the CMS

[2114]AuthorizationException—if the current user does not havepermission to perform this operation

[2115] 1.1.24.2 getItem

[2116] public ItemgetItem(com.conceptis.util.PrimaryKey key, booleanlockForEditing)

[2117] throws ConnectionException, AuthorizationException,java.lang.IllegalStateException, MissingResourceException

[2118] Provides the Item with the specified key.

[2119] Parameters:

[2120] key—the primary key of the Item

[2121] lockForEditing—set to true to retrieve this Item in edition mode,allowing the changes made to it to be saved; set to false to get thisItem in a read-only mode.

[2122] Returns:

[2123] the Item with the specified key

[2124] Throws:

[2125]ConnectionException—if there is a problem interacting with the CMS

[2126]AuthorizationException—if the current user does not havepermission to perform this operation

[2127] java.lang.IllegalStateException—if the Item is already locked forediting by another party

[2128]MissingResourceException—if the Item specified by the key does notexist

[2129] 1.1.24.3 getItems

[2130] public java.util.Set getItems(ItemType itemType, Item top)

[2131] throws ConnectionException, AuthorizationException

[2132] Returns a Set of Item that all share the same ItemType and areunder the same Item.

[2133] Parameters:

[2134] itemType—the ItemType shared by all returned Items

[2135] top—the Item that represents the branch to search under.

[2136] Returns:

[2137] a Set of Item that all share the same ItemType.

[2138] Throws:

[2139]ConnectionException—if there is a problem interacting with the CMS

[2140]AuthorizationException—if the current user does not havepermission to perform this operation

[2141] 1.1.24.4 getItem

[2142] public Item getItem(java.lang.String identifier, booleanlockForEditing)

[2143] throws ConnectionException, AuthorizationException,java.lang.IllegalStateException, MissingResourceException

[2144] Provides the Item with the specified identifier.

[2145] Parameters:

[2146] identifier—a string that uniquely identifies the desired resource

[2147] lockForEditing—set to true to retrieve this Item in edition mode,allowing the changes made to it to be saved; set to false to get thisItem in a read-only mode.

[2148] Returns:

[2149] the Item with the specified identifier

[2150] Throws:

[2151]ConnectionException—if there is a problem interacting with the CMS

[2152]AuthorizationException—if the current user does not havepermission to perform this operation

[2153] java.lang.IllegalStateException—if the Item is already locked forediting by another party

[2154]MissingResourceException—if the Item specified by the key does notexist

[2155] 1.1.24.5 getItem

[2156] public Item getItem(java.net.URL identifier, booleanlockForEditing)

[2157] throws ConnectionException, AuthorizationException,java.lang.IllegalStateException, MissingResourceException

[2158] Provides the Item with the specified URL.

[2159] Parameters:

[2160] identifier—a string that uniquely identifies the desired resourcelockForEditing—set to true to retrieve this Item in edition mode,allowing the changes made to it to be saved; set to false to get thisItem in a read-only mode.

[2161] Returns:

[2162] the Item with the specified identifier

[2163] Throws:

[2164]ConnectionException—if there is a problem interacting with the CMSAuthorizationException—if the current user does not have permission toperformn this operation

[2165] java.lang.IllegalStateException- if the Item is already lockedfor editing by another party

[2166]MissingResourceException—if the Item specified by the key does notexist

[2167] 1.1.24.6 getRootItems

[2168] public java.util.Set getRootItems ( )

[2169] throws ConnectionException, AuthorizationException,MissingResourceException

[2170] Provides the root ItemS of the site.

[2171] Returns:

[2172] the root Items of the site

[2173] Throws:

[2174]ConnectionException—if there is a problem interacting with the CMS

[2175]AuthorizationException—if the current user does not havepermission to perform this operation

[2176]MissingResourceException—if the Items do not exist

[2177] 1.1.24.7 addRootitem

[2178] public void addRootitem(Item root)

[2179] throws ConnectionException, AuthorizationException,MissingResourceException

[2180] Sets the root Item of the site.

[2181] Parameters:

[2182] root—the root Item of the site

[2183] Throws:

[2184]ConnectionException—if there is a problem interacting with the CMS

[2185]AuthorizationException—if the current user does not havepermission to perform this operation

[2186]MissingResourceException—if the Item specified by the key does notexist

[2187] 1.1.24.8 removeRootitem

[2188] public void removeRootItem(Item root)

[2189] throws ConnectionException, AuthorizationException,MissingResourceException

[2190] Sets the root Item of the site.

[2191] Parameters:

[2192] root—the root Item of the site

[2193] Throws:

[2194]ConnectionException—if there is a problem interacting with the CMS

[2195]AuthorizationException—if the current user does not havepermission to perform this operation

[2196]MissingResourceException—if the Item specified by the key does notexist

[2197] 1.1.24.9 getItems

[2198] public java.util.Set getItems(ItemType itemType)

[2199] throws ConnectionException, AuthorizationException

[2200] Returns a Set of Item that all share the same ItemType.

[2201] Parameters:

[2202] itemType—the ItemType shared by all returned ItemS

[2203] Returns:

[2204] a Set of Item that all share the same ItemType.

[2205] Throws:

[2206]ConnectionException—if there is a problem interacting with the CMS

[2207]AuthorizationException—if the current user does not havepermission to perform this operation

[2208] 1.1.24.10 createNewitem

[2209] public Item createNewItem(ItemType itemType)

[2210] Creates a new Item instance, uninitialized, not stored in theCMS. Once correctly initialized, this instance may then be inserted inthe CMS using the saveItem(com.conceptis.cms.Item) method.

[2211] Parameters:

[2212] itemType—the ItemType of the newly created Item

[2213] Returns:

[2214] an unitialized Item of the specified ItemType

[2215] 1.1.24.11 saveItem

[2216] public void saveItem(Item item)

[2217] throws ConnectionException, AuthorizationException,MissingResourceException, java.lang.IllegalStateException

[2218] Saves the specified Item. This will change the Item's entry inthe CMS to reflect the state of the item parameter. If the given Itemdid not exist before, it will be inserted, otherwise it will simply beupdated. If the Item was locked for editing, it will be unlocked.

[2219] Parameters:

[2220] item—the Item to insert/update

[2221] Throws:

[2222]ConnectionException—if there is a problem interacting with the CMS

[2223]AuthorizationException—if the current user does not havepermission to perform this operation

[2224]MissingResourceException—if a previously existing Item does notexist any longer java.lang.IllegalStateException—if trying to save anItem that was not locked for editing when retrieved.

[2225] 1.1.24.12 unlockItem

[2226] public void unlockItem(Item item)

[2227] throws ConnectionException, AuthorizationException,MissingResourceException

[2228] Unlocks the specified Item without saving any changes, thereforemaking it available for editing to someone else. If the Item was notlocked, this method will simply do nothing.

[2229] Parameters:

[2230] item—the Item to unlock

[2231] Throws:

[2232]ConnectionException—if there is a problem interacting with the CMS

[2233]AuthorizationException—if the current user does not havepermission to perform this operation

[2234]MissingResourceException—if a previously existing Item does notexist any longer

[2235] 11.1.24.13 lockItem

[2236] public void lockItem(Item item)

[2237] throws ConnectionException, AuthorizationException,MissingResourceException

[2238] Unlocks the specified Item without saving any changes, thereforemaking it available for editing to someone else. If the Item was notlocked, this method will simply do nothing. Authorization required: none

[2239] Parameters:

[2240] item—the Item to unlock

[2241] Throws:

[2242]ConnectionException—if there is a problem interacting with the CMS

[2243]AuthorizationException—if the current user does not havepermission to perform this operation

[2244]MissingResourceException—if a previously existing Item does notexist any longer

[2245] 1.1.24.14 deleteItem

[2246] public void deleteItem(Item item)

[2247] throws ConnectionException, AuthorizationException,MissingResourceException

[2248] Deletes this Item. This may have unintended consequences. Notethat some implementations may throw an UnsupportedoperationException ifthe deletion of Items is not possible.

[2249] Parameters:

[2250] item—the Item to delete

[2251] Throws:

[2252]ConnectionException—if there is a problem interacting with the CMS

[2253]AuthorizationException—if the current user does not havepermission to perform this operation

[2254]MissingResourceException—if the Item does not exist any longer

[2255] 1.1.24.15 searchForItem

[2256] public java.util.Set searchForitem(ItemSearchConstraintsconstraints)

[2257] throws ConnectionException, AuthorizationException

[2258] Deprecated. use search(com.conceptis.cms.ItemSearchConstraints),which returns a paged list

[2259] Searches for Items matching the constraints.

[2260] Parameters:

[2261] constraints—the constraints of the search

[2262] Returns:

[2263] a set of items matching the constraints

[2264] Throws:

[2265]ConnectionException—if there is a problem interacting with the CMS

[2266]AuthorizationException—if the current user does not havepermission to perform this operation

[2267] 1.1.24.16 search

[2268] public com.conceptis.util.PagedList search(ItemSearchConstraintsconstraints)

[2269] throws ConnectionException, AuthorizationException,MissingResourceException

[2270] Searches for Items matching the constraints.

[2271] Parameters:

[2272] constraints—the constraints of the search

[2273] Returns:

[2274] a set of items matching the constraints

[2275] Throws:

[2276]ConnectionException—if there is a problem interacting with the CMS

[2277]AuthorizationException—if the current user does not havepermission to perform this operation

[2278]MissingResourceException—if the search could not be performed

1.1.25 INTERFACE ITEMTYPE

[2279] All Superinterfaces:

[2280]ObjectWithPrimaryKey

[2281] public interface ItemType

[2282] extends ObjectWithPrimaryKey

[2283] An ItemType defines a family of Items that all share the sameconstraints, Fields, PublishingFlow, etc. Method Summary voidaddField(Field field) Adds a Field in this ItemType. void addField(intindex, Field field) Adds a Field in this ItemType. voidaddRelatedItemType(RelationType relationType, ItemType itemType) Linksan ItemType to this one, using the given RelationType to define the linkitself. java.util.Set getChildren( ) Provides the children types of thistype. Collection getCollection( ) Provides the Collection that thisItemType belongs to. Field getField(int index) Returns the Fieldidentified by the provided index. Field getField(java.lang.String name)Returns the Field identified by the given name. java.util.ListgetFields( ) Returns a List of Fields defined in this ItemType.java.util.Set getItems( ) Returns all the Items that share thisItemType. int getMaximumVersions( ) Provides the number of versions thatshould be maintained for this ItemType. java.lang.String getName( )Returns the name of this ItemType. ItemType getParent( ) Provides theparent type of this type. PublishingFlow getPublishingFlow( ) Returnsthe PublishingFlow assigned to this ItemType. java.util.SetgetRelatedItemTypes(RelationType relationType) Returns a Set ofItemTypeS related to this ItemType by the given RelationType. booleanisBinary( ) Indicates whether this resource type contains binarycontent. void removeField(int index) Removes the Field at the specifiedindex. void removeField(java.lang.String name) Removes the Field at thespecified index. void removeRelatedItemType(RelationType relationType,Item item) Removes the link between the given ItemType and this one, thelink being defined by the given RelationType. void setCollection(Collection collection) Sets the Collection that this type is definedin. void setName(java.lang.String name) Sets the name of this ItemType.void setPublishingFlow(PublishingFlow publishingFlow) Sets thePublishingFlow of this ItemType. boolean supportsExtendedRelationships() Indicates whether this type supports extended relationships. booleansupportsLocalizedString( ) Indicates whether this type supports alocalized string.

[2284] Methods in herited from interface com.conceptis.cms.0bjectWithPrimaryKey

[2285]getPrimaryKey

Method Detail

[2286] 1.1.25.1 setName

[2287] public void setName(java.lang.String name)

[2288] throws AuthorizationException, ConnectionException

[2289] Sets the name of this ItemType.

[2290] Parameters:

[2291] name—the name of this ItemType

[2292] Throws:

[2293]AuthorizationException—if the current user does not havepermission to perform this operation ConnectionException—if there is aproblem interacting with the CMS; this will only be thrown,; if thedriver ilpcmcnttion choses to use ueferred data loading (for performancereason).

[2294] 1.1.25.2 getName

[2295] public java.lang.String getName ( )

[2296] throws AuthorizationException, ConnectionException

[2297] Returns the name of this ItemType.

[2298] Returns:

[2299] the name of this ItemType

[2300] Throws:

[2301]AuthorizationException—if the current user does not havepermission to perform this operation

[2302]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2303] 1.1.25.3 addField

[2304] public void addField(Field field)

[2305] throws AuthorizationException, ConnectionException

[2306] Adds a Field in this ItemType. The field is placed at the end ofthe list.

[2307] Parameters:

[2308] field—the Field to set

[2309] Throws:

[2310]AuthorizationException—if the current user does not havepermission to perform this operation

[2311]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2312] 1.1.25.4 addField

[2313] public void addField(int index, Field field)

[2314] throws AuthorizationException, ConnectionException,java.lang.IndexoutOfBoundsException

[2315] Adds a Field in this ItemType. The index can be specified.

[2316] Parameters:

[2317] index—the index of the Field field—the Field to set

[2318] Throws:

[2319]AuthorizationException—if the current user does not havepermission to perform this operation

[2320]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2321] java.lang.IndexOutOfBoundsException—if the index is negative orlarger then the current field count

[2322] 1.1.25.5 getField

[2323] public Field getField(java.lang.string name)

[2324] throws AuthorizationException, ConnectionException

[2325] Returns the Field identified by the given name.

[2326] Parameters:

[2327] name—the name of the field

[2328] Returns:

[2329] the Field that fits the specified name, null if it is not a fieldof this type

[2330] Throws:

[2331]AuthorizationException—if the current user does not havepermission to perform this operation

[2332]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2333] 1.1.25.6 getField

[2334] public Field getfield(int index)

[2335] throws AuthorizationException, ConnectionException,java.lang.IndexoutofBoundsException

[2336] Returns the Field identified by the provided index.

[2337] Parameters:

[2338] index—the index of the field

[2339] Returns:

[2340] the Field that fits the specified name

[2341] Throws:

[2342]AuthorizationException—if the current user does not havepermission to perform this operation

[2343]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2344] java.lang.IndexOutOfBoundsException—if the index is invalid

[2345] 1.1.25.7 removeField

[2346] public void removeField(java.lang.String name)

[2347] throws AuthorizationException, ConnectionException

[2348] Removes the Field at the specified index.

[2349] Parameters:

[2350] name—the name of the field

[2351] Throws:

[2352]AuthorizationException—if the current user does not havepermission to perform this operation

[2353]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2354] 1.1.25.8 removeField

[2355] public void removefield(int index)

[2356] throws AuthorizationException, ConnectionException,java.lang.IndexoutofBoundsException

[2357] Removes the Field at the specified index.

[2358] Parameters:

[2359] index—the index of the field

[2360] Throws:

[2361]AuthorizationException—if the current user does not havepermission to perform this operation

[2362]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2363] java.lang.IndexoutofBoundsException—if the index is invalid

[2364] 1.1.25.9 getFields

[2365] public java.util.List getFields ( )

[2366] throws AuthorizationException, ConnectionException

[2367] Returns a List of Fields defined in this ItemType.

[2368] Returns:

[2369] a List of Fields defined in this ItemType, in no particular order

[2370] Throws:

[2371]AuthorizationException—if the current user does not havepermission to perform this operation

[2372]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2373] 1.1.25.10 setPublishingFlow

[2374] public void setPublishingFlow(PublishingFlow publishingFlow)

[2375] throws AuthorizationException, ConnectionException

[2376] Sets the PublishingFlow of this ItemType.

[2377] Parameters:

[2378] publishingFlow—PublishingFlow to assign to this ItemType

[2379] Throws:

[2380]AuthorizationException—if the current user does not havepermission to perform this operation

[2381]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2382] 1.1.25.11 getPublishingFlow

[2383] public PublishingFlow getPublishingFlow ( )

[2384] throws AuthorizationException, ConnectionException,MissingResourceException

[2385] Returns the PublishingFlow assigned to this ItemType.

[2386] Returns:

[2387] the PublishingFlow assigned to this ItemType

[2388] Throws:

[2389]AuthorizationException—if the current user does not havepermission to perform this operation

[2390]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2391]MissingResourceException—if the flow does not exist

[2392] 1.1.25.12 getcollection

[2393] public Collection getCollection ( )

[2394] throws AuthorizationException, ConnectionException,MissingResourceException

[2395] Provides the Collection that this ItemType belongs to. It ispossible that this value is null, since a type is not required to be ina collection.

[2396] Returns:

[2397] the collection the type is in, or null if it is not in acollection

[2398] Throws:

[2399]AuthorizationException—if the current user does not havepermission to perform this operation

[2400]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2401]MissingResourceException—if the collection does not exist

[2402] 1.1.25.13 setCollecbon

[2403] public void setCollection(Collection collection)

[2404] throws AuthorizationException, ConnectionException

[2405] Sets the Collection that this type is defined in. It isacceptable to pass null into this method, since a type is not requiredto be in a collection.

[2406] Parameters:

[2407] collection—the collection that the type is in, pass null toremove the type

[2408] Throws:

[2409]AuthorizationException—if the current user does not havepermission to perform this operation

[2410]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2411] 1.1.25.14 getparent

[2412] public ItemType getparent ( )

[2413] throws AuthorizationException, ConnectionException,MissingResourceException

[2414] Provides the parent type of this type.

[2415] Returns:

[2416] the parent type of this type

[2417] Throws:

[2418]AuthorizationException—if the current user does not havepermission to perform this operation

[2419]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2420]MissingResourceException—if the parent does not exist

[2421]1.1.25.15 getchildren

[2422] public java.util.Set getChildren ( )

[2423] throws AuthorizationException, ConnectionException,MissingResourceException

[2424] Provides the children types of this type.

[2425] Returns:

[2426] the children types of this type

[2427] Throws:

[2428]AuthorizationException—if the current user does not havepermission to perform this operation

[2429]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2430]MissingResourceException—if the parent does not exist

[2431] 1.1.25.16 getMaximumVersions

[2432] public int getMaximumVersions ( )

[2433] throws AuthorizationException, ConnectionException

[2434] Provides the number of versions that should be maintained forthis ItemType.

[2435] Returns:

[2436] the number of versions to maintained for this type

[2437] Throws:

[2438]AuthorizationException—if the current user does not havepermission to perform this operation

[2439]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2440] 1.1.25.17 isBinary

[2441] public boolean isBinary ( )

[2442] throws AuthorizationException, ConnectionException

[2443] Indicates whether this resource type contains binary content.

[2444] Returns:

[2445] true if the Item contains binary content, false otherwise

[2446] Throws:

[2447]AuthorizationException—if the current user does not havepermission to perform this operation

[2448]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2449] 1.1.25.18 getItems

[2450] public java.util.Set getItems ( )

[2451] throws AuthorizationException, ConnectionException,MissingResourceException

[2452] Returns all the Items that share this ItemType.

[2453] Returns:

[2454] a Set of Items that all share this ItemType

[2455] Throws:

[2456]AuthorizationException—if the current user does not havepermission to perform this operation

[2457]ConnectionException—if there is a problem interacting with the CMS

[2458]MissingResourceException—if an item is missing

[2459] 1.1.25.19 addRelatedItemType

[2460] public void addRelatedItemType(RelationType relationType,ItemTypeitemType)

[2461] throws AuthorizationException, ConnectionException,java.lang.IllegalStateException

[2462] Links an ItemType to this one, using the given RelationType todefine the link itself The relation type works like this: if you want todefine an image type for a news type, you would call something similarto the following line of code:

[2463] this.addRelatedItemType(“news.image”, imageType);.

[2464] Parameters:

[2465] relationType—the RelationType that characterizes the link betweenthis ItemType and the other. itemType—the ItemType to link to thisItemType

[2466] Throws:

[2467]AuthorizationException—if the current user does not havepermission to perform this operation

[2468]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2469] java.lang.IllegalStateException—if the specified RelationTypealready defines a unique linked ItemType

[2470] 1.1.25.20 getRelateditemTypes

[2471] public java.util.Set getRelatedItemTypes(RelationTyperelationType)

[2472] throws AuthorizationException, ConnectionException

[2473] Returns a Set of ItemTypes related to this ItemType by the givenRelationType. The Set may be empty, but never null.

[2474] Parameters:

[2475] relationType—the RelationType that characterizes the link betweenthis ItemType and the others.

[2476] Returns:

[2477] Set of ItemTypes related to this one by the given RelationType

[2478] Throws:

[2479]AuthorizationException—if the current user does not havepermission to perform this operation

[2480]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2481] 1.1.25.21 removeRelatedItemType

[2482] public void removeRelatedItemType(RelationType relationType, Itemitem)

[2483] throws AuthorizationException, ConnectionException

[2484] Removes the link between the given ItemType and this one, thelink being defined by the given RelationType. The relation type workslike this: if you want to remove an image ItemType from a news ItemType,you would call something similar to the following line of code:this.removeRelatedItem(“news.image”, imageType);.

[2485] Parameters:

[2486] relationType—the RelationType that characterizes the link betweenthis ItemType and the other.

[2487] item—the ItemType to unlink from this ItemType

[2488] Throws:

[2489]AuthorizationException—if the current user does not havepermission to perform this operation

[2490]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2491] 1.1.25.22 supportsExtendedRelationships

[2492] public boolean supportsExtendedRelationships ( )

[2493] throws AuthorizationException, ConnectionException

[2494] Indicates whether this type supports extended relationships.

[2495] Returns:

[2496] true if the item supports extended relationships, false othe,vise

[2497] Throws:

[2498]AuthorizationException—if the current user does not havepermission to perform this operation

[2499]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2500] 1.1.25.23 supportsLocalizedString

[2501] public boolean supportsLocalizedString ( )

[2502] throws AuthorizationException, ConnectionException

[2503] Indicates whether this type supports a localized string.

[2504] Returns:

[2505] true if the item supports elocalized string, false otherwise

[2506] Throws:

[2507]AuthorizationException—if the current user does not havepermission to perform this operation

[2508]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

1.1.26 INTERFACE ITEMTYPEFACTORY

[2509] public interface ItemTypeFactory

[2510] Interacts with the CMS to provide access to item types of theCMS. Method Summary ItemType createNewItemType( ) Creates a new ItemTypeinstance, uninitialized, not stored in the CMS. voiddeleteItemType(ItemType itemType) Deletes this ItemType. ItemTypegetItemType(com.conceptis.util.PrimaryKey key) Provides the ItemTypewith the specified key. ItemType getItemType(java.lang.String name)Provides the ItemType with the specified name. java.util.SetgetItemTypes( ) Provides the set of all ItemTypeS. voidsaveItemType(ItemType itemType) Saves the specified ItemType.

Method Detail

[2511] 1.1.26.1 getItemTypes

[2512] public java.util.Set getItemTypes ( )

[2513] throws ConnectionException, AuthorizationException

[2514] Provides the set of all ItemTypeS.

[2515] Returns:

[2516] the set of all ItemTypees (may be empty but never null)

[2517] Throws:

[2518]ConnectionException—if there is a problem interacting with the CMS

[2519]AuthorizationException—if the current user does not havepermission to perform this operation

[2520] 1.1.26.2 getItemType

[2521] public ItemType getItemType(com.conceptis.util.PrimaryKey key)

[2522] throws ConnectionException, AuthorizationException,MissingResourceException

[2523] Provides the ItemType with the specified key.

[2524] Parameters:

[2525] key—the primary key of the ItemType

[2526] Returns:

[2527] the Itemtype with the specified key

[2528] Throws:

[2529]ConnectionException—if there is a problem interacting with the CMS

[2530]AuthorizationException—if the current user does not havepermission to perform this operation

[2531]

[2532]MissingResourceException—if the ItemType specified by the key doesnot exist

[2533] 1.1.26.3 getItemType

[2534] public ItemType getItemType(java.lang.String name)

[2535] throws ConnectionException, AuthorizationException,MissingResourceException

[2536] Provides the Itemtype with the specified name.

[2537] Parameters:

[2538] name—the name of the ItemType

[2539] Returns:

[2540] the ItemType with the specified key

[2541] Throws:

[2542]ConnectionException—if there is a problem interacting with the CMS

[2543]AuthorizationException—if the current user does not havepermission to perform this operation

[2544]MissingResourceException—if the ItemType specified by the key doesnot exist

[2545] 1.1.26.4 createNewItemType

[2546] public ItemType createNewItemType ( )

[2547] Creates a new ItemType instance, uninitialized, not stored in theCMS. Once correctly initialized, this instance may then be inserted inthe CMS using the saveItemType (com.conceptis.cms.ItemType) method.

[2548] Returns:

[2549] the newly created ItemType

[2550] 1.1.26.5 saveItemType

[2551] public void saveItemType(ItemType itemType)

[2552] throws ConnectionException, AuthorizationException,MissingResourceException

[2553] Saves the specified ItemType. This will change the item type'sentry in the CMS to reflect the state of the itemType parameter.

[2554] Parameters:

[2555] itemType—the ItemType to insert/update

[2556] Throws:

[2557]ConnectionException—if there is a problem interacting with the CMS

[2558]AuthorizationException—if the current user does not havepermission to perform this operation

[2559]MissingResourceException—if a previously existing ItemType doesnot exist any longer

[2560] 1.1.26.6 deleteItemType

[2561] public void deleteItemType(ItemType itemType)

[2562] throws ConnectionException, AuthorizationException,MissingResourceException

[2563] Deletes this ItemType. This may have unintended consequences.Note that some implementations may throw anUnsupportedoperationException if the deletion of

[2564] ItemTypes is not possible.

[2565] Parameters:

[2566] itemType—the ItemType to delete

[2567] Throws:

[2568]ConnectionException—if there is a problem interacting with the CMS

[2569]AuthorizationException—if the current user does not havepermission to perform this operation

[2570]MissingResourceException—if the ItemType does not exist any longer

1.1.27 INTERFACE ITEMTYPEFACTORY

[2571] public interface ItemTypeFactory

[2572] Interacts with the CMS to provide access to item types of theCMS. Method Summary ItemType createNewItemType( ) Creates a new ItemTypeinstance, uninitialized, not stored in the CMS. voiddeleteItemType(ItemType itemType) Deletes this ItemType. ItemTypegetItemType(com.conceptis.util.PrimaryKey key) Provides the ItemTypewith the specified key. ItemType getItemType(java.lang.String name)Provides the ItemType with the specified name. java.util.SetgetItemTypes( ) Provides the set of all ItemTypeS. voidsaveItemType(ItemType itemType) Saves the specified ItemType.

Method Detail

[2573] 1.1.27.1 getItemTypes

[2574] public java.util.Set getItemTypes ( )

[2575] throws ConnectionException, AuthorizationException

[2576] Provides the set of all ItemTypeS.

[2577] Returns:

[2578] the set of all ItemTypees (may be empty but never null)

[2579] Throws:

[2580]ConnectionException—if there is a problem interacting with the CMS

[2581]AuthorizationException—if the current user does not havepermission to perform this operation

[2582] 1.1.27.2 getItemType

[2583] public ItemType getItemType(com.conceptis.util.PrimaryKey key)

[2584] throws ConnectionException, AuthorizationException,MissingResourceException

[2585] Provides the ItemType with the specified key.

[2586] Parameters:

[2587] key—the primary key of the ItemType

[2588] Returns:

[2589] the ItemType with the specified key

[2590] Throws:

[2591]ConnectionException—if there is a problem interacting with the CMS

[2592]AuthorizationException—if the current user does not havepermission to perform this operation

[2593]MissingResourceException—if the ItemType specified by the key doesnot exist

[2594] 1.1.27.3 getitemType

[2595] public ItemType getItemType(java.lang.String name)

[2596] throws ConnectionException, AuthorizationException,MissingResourceException

[2597] Provides the ItemType with the specified name.

[2598] Parameters:

[2599] name—the name of the ItemType

[2600] Returns:

[2601] the ItemType with the specified key

[2602] Throws:

[2603]ConnectionException—if there is a problem interacting with the CMS

[2604]AuthorizationException—if the current user does not havepermission to perform this operation

[2605]MissingResourceException—if the ItemType specified by the key doesnot exist

[2606] 1.1.27.4 createNewItemType

[2607] public ItemType createNewItemType ( )

[2608] Creates a new ItemType instance, uninitialized, not stored in theCMS. Once correctly initialized, this instance may then be inserted inthe CMS using the saveItemType (com.conceptis.cms.ItemType) method.

[2609] Returns:

[2610] the newly created ItemType

[2611] 1.1.27.5 saveItemType

[2612] public void saveItemType(ItemType itemType)

[2613] throws ConnectionException, AuthorizationException,MissingResourceException

[2614] Saves the specified ItemType. This will change the item type'sentry in the CMS to reflect the state of the itemType parameter.

[2615] Parameters:

[2616] itemType—the ItemType to insert/update

[2617] Throws:

[2618]ConnectionException—if there is a problem interacting with the CMS

[2619]AuthorizationException—if the current user does not havepermission to perform this operation

[2620]MissingResourceException—if a previously existing ItemType doesnot exist any longer

[2621] 1.1.27.6 deleteItemType

[2622] public void deleteItemType(ItemType itemType)

[2623] throws ConnectionException, AuthorizationException,MissingResourceException

[2624] Deletes this ItemType. This may have unintended consequences.Note that some implementations may throw anUnsupportedoperationException if the deletion of ItemTypes is notpossible.

[2625] Parameters:

[2626] itemType—the ItemType to delete

[2627] Throws:

[2628]ConnectionException—if there is a problem interacting with the CMS

[2629]AuthorizationException—if the current user does not havepermission to perform this operation

[2630]MissingResourceException—if the ItemType does not exist any longer

1.1.28 INTERFACE OBJECTWITHPRIMARYKEY

[2631] All Known Subinterfaces:

[2632] CmsUser, CmsUserGroup, Collection, Field, Index, Item, ItemType,PublicationStatus, PublishineFlow

[2633] public interface ObjectWithPrimaryKey Method Summarycom.conceptis.util.PrimaryKey getPrimaryKey( ) Provides the object'sprimary key.

Method Detail

[2634] 1.1.28.1 getPrimaryKey

[2635] public com.conceptis.util.PrimaryKey getPrimaryKey ( )

[2636] throws AuthorizationException

[2637] Provides the object's primary key.

[2638] Returns:

[2639] the primary key identifying the object

[2640] Throws:

[2641]AuthorizationException—if the user does not have permission toperform this operation

1.1.29 INTERFACE PUBLICATIONSTATUS

[2642] All Superinterfaces:

[2643]ObjectWithPrimaryKey

[2644] public interface PublicationStatus

[2645] extends ObjectWithPrimaryKey

[2646] A PublicationStatus is the smallest component in aPublishingFlow. Field Summary static java.lang.String SIGN OFFAUTOMATICALLY AFTER Defines a PublicationStatus that is signed offautomatically after a given amount of time, set bysetSignOffDelay(long). static java.lang.String SIGN OFF AUTOMATICALLY ATDefines a PublicationStatus that is signed off automatically at aspecific moment, set by setSignOffDate(java.util.Date). staticjava.lang.String SIGN OFF MANUALLY Defines a PublicationStatus thatrequires a manual sign off. Method Summary voidaddGroupToNotify(CmsUserGroup group) Adds a CmsUserGroup to the list ofgroups that are notified when an item reaches this status. booleangetEmailNotification( ) Returns the email notification status that willbe used when the associated Item reaches this PublicationStatus.java.util.Set getGroupsToNotify( ) Provides the set of all theCmsUserGroups that are sent notification when an item reaches thisstatus. java.lang.String getName( ) Returns the name of thisPublicationStatus. java.util.Date getSignOffDate( ) Deprecated. thisshould not be here, it is set by item long getSignOffDelay( ) Returnsthe delay (in milliseconds) to wait before the Item to which thisPublicationStatus was assigned can be signed off automatically.java.lang.String getSignOffMethod( ) Returns the sign-off method of thisPublicationStatus. boolean getSignoffToNewVersion( ) Return true if theassociated Item will be assigned a new version when it leaves thisPublicationStatus. boolean isViewable( ) Returns the visibility statusof the associated Item when it reaches this PublicationStatus. voidremoveGroupToNotify(CmsUserGroup group) Removes a CmsUserGroup from thelist of groups that are notified when an item reaches this status. voidsetEmailNotification(boolean emailNotification) When set to true, anemail will be sent when the associated Item reaches thisPublicationStatus. void setName(java.lang.String name) Sets the name ofthis PublicationStatus. void setSignOffDate(java.util.Date date)Deprecated. this should not be here, it is set by item voidsetSignOffDelay(long delay) Sets the delay (in milliseconds) to waitbefore the Item to which this PublicationStatus was assigned can besigned off automatically. void setSignOffMethod(java.lang.StringsignOffMethod) Sets the sign-off method of this PublicationStatus. voidsetSignOffToNewVersion(boolean signOffToNewVersion) When set to true,the associated Item will be assigned a new version when it leaves thisPublicationStatus. void setViewable(boolean viewable) When set to true,the associated Item will be viewable when it reaches thisPublicationStatus.

[2647] Methods inherited from interfacecom.conceptis.cms.ObjectWithPrimaryKey

[2648] getPrimaryKey

Field Detail

[2649] 1.1.29.1 SIGN_OFF_MANUALLY

[2650] public static final java.lang.String SIGN_OFF_MANUALLY

[2651] Defines a PublicationStatus that requires a manual sign off.

[2652] See Also:

[2653]Constant Field Values

[2654] 1.1.29.2 SIGN_OFF_AUTOMATICALLY_AFTER

[2655] public static final java.lang.String SIGN_OFF_AUTOMATICALLY_AFTER

[2656] Defines a PublicationStatus that is signed off automaticallyafter a given amount of time, set by setSignoffDelay(long). The

[2657] See Also:

[2658] Constant Field Values

[2659] 1.1.29.3 SIGN_OFF_AUTOMATICALLY_AT

[2660] public static final java.lang.String SIGN_OFF_AUTOMATICALLY_AT

[2661] Defines a PublicationStatus that is signed off automatically at aspecific moment, set by setSignOffDate(java.util.Date).

[2662] See Also:

[2663] Constant Field Values

Method Detail

[2664] 1.1.29.4 setName

[2665] public void setName(java.lang.String name)

[2666] throws AuthorizationException, ConnectionException

[2667] Sets the name of this PublicationStatus.

[2668] Parameters:

[2669] name—the name of this PublicationStatus

[2670] Throws:

[2671]AuthorizationException—if the current user does not havepermission to perform this operation

[2672]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2673] 1.1.29.5 getName

[2674] public java.lang.String getName ( )

[2675] throws AuthorizationException, ConnectionException

[2676] Returns the name of this PublicationStatus.

[2677] Returns:

[2678] the name of this PublicationStatus

[2679] Throws:

[2680]AuthorizationException—if the current user does not havepermission to perform this operation

[2681]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason). p0 1.1.29.6setSignOffMethod

[2682] public void setSignOffMethod(java.lang.String signOffMethod)

[2683] throws AuthorizationException, ConnectionException

[2684] Sets the sign-off method of this PublicationStatus. Acceptablevalues are defined as constants in this interface and are calledSIGN_OFF_XYZ. Some of them may require an additional call to method inorder to be valid.

[2685] Parameters:

[2686] signoffMethod—one of the SIGN_OFF_XYZ constants

[2687] Throws:

[2688]AuthorizationException—if the current user does not havepermission to perform tnis operation

[2689]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2690] 1.1.29.7 getSignOffMethod

[2691] public java.lang.String getSignOffMethod ( )

[2692] throws AuthorizationException, ConnectionException

[2693] Returns the sign-off method of this PublicationStatus.

[2694] Returns:

[2695] one of the SIGN_OFF_XYZ constants

[2696] Throws:

[2697]AuthorizationException—if the current user does not havepermission to perform this operation

[2698]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2699] 1.1.29.8 setSignOffDelay

[2700] public void setSignOffDelay(long delay)

[2701] throws AuthorizationException, ConnectionException,java.lang.IllegalStateException

[2702] Sets the delay (in milliseconds) to wait before the Item to whichthis PublicationStatus was assigned can be signed off automatically.This only applies to a PublicationStatus that has been set to SIGN OFFAUTOMATICALLY AFTER.

[2703] Parameters:

[2704] delay—the number of milliseconds to wait before the Item to whichthis PublicationStatus was assigned can be signed off automatically

[2705] Throws:

[2706] java. lang. IllegalStateException—if the sign-off method doesn'tsupport such a setting

[2707]AuthorizationException—if the current user does not havepermission to perform this operation

[2708]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2709] 1.1.29.9 getSignOffDelay

[2710] public long getSignOffDelay ( )

[2711] throws AuthorizationException, ConnectionException

[2712] Returns the delay (in milliseconds) to wait before the Item towhich this PublicationStatus was assigned can be signed offautomatically. This only applies to a PublicationStatus that has beenset to SIGN OFF AUTOMATICALLY AFTER.

[2713] Returns:

[2714] the number of milliseconds to wait before the Item to which thisPublicationStatus was assigned can be signed off automaticaiiy

[2715] Throws:

[2716]AuthorizationException—if the current user does not havepermission to perform this operation

[2717]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2718] 1.1.29.10 setSignOffDate

[2719] public void setSignOffDate(java.util.Date date)

[2720] throws AuthorizationException, ConnectionException,java.lang.IllegalStateException

[2721] Deprecated. this should not be here, it is set by item

[2722] Sets the DateItem to which this PublicationStatus was assignedcan be signed off automatically. This only applies to aPublicationStatus that has been set to SIGN OFF AUTOMATICALLY AT.

[2723] Parameters:

[2724] date—the Date to reach before the Item to which thisPublicationStatus was assigned can be signed off automatically

[2725] Throws:

[2726] java.lang.IllegalStateException—if the sign-off method doesn'tsupport such a setting

[2727]AuthorizationException—if the current user does not havepermission to perform this operation

[2728]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2729] 1.1.29.11 getSignOffDate ( )

[2730] public java.util.Date getSignOffDate ( )

[2731] throws AuthorizationException, ConnectionException

[2732] Deprecated. this should not be here, it is set by item

[2733] Returns the DateItem to which this PublicationStatus was assignedcan be signed off automatically. This only applies to aPublicationStatus that has been set to SIGN OFF AUTOMATICALLY AT.

[2734] Returns:

[2735] the Date to reach before the Item to which this PublicationStatuswas assigned can be signed off automatically

[2736] Throws:

[2737]AuthorizationException—if the current user does not havepermission to perform this operation

[2738]Connectiongxception—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2739] 1.1.29.12 setViewable

[2740] public void setViewable(boolean viewable)

[2741] throws AuthorizationException, ConnectionException

[2742] When set to true, the associated Item will be viewable when itreaches this PublicationStatus.

[2743] Parameters:

[2744] viewable—set to true to make the associated Item visible; set tofalse to keep it invisible

[2745] Throws:

[2746]AuthorizationException—if the current user does not havepermission to perform this operation

[2747]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2748] 1.1.29.13 isViewable

[2749] public boolean isViewable ( )

[2750] throws AuthorizationException, ConnectionException

[2751] Returns the visibility status of the associated Item when itreaches this PublicationStatus.

[2752] Returns:

[2753] true if the associated Item is visible; false otherwise

[2754] Throws:

[2755]AuthorizationException—if the current user does not havepermission to perform this operation

[2756]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2757] 1.1.29.14 setEmailNotification

[2758] public void setEmailNotification(boolean emailNotification)

[2759] throws AuthorizationException, ConnectionException

[2760] When set to true, an email will be sent when the associated Itemreaches this PublicationStatus.

[2761] Parameters:

[2762] emailNotification—set to true to send an email notification whenthe associated Item reaches this PublicationStatus; set to false todisable email notification

[2763] Throws:

[2764]AuthorizationException—if the current user does not havepermission to perform this operation

[2765]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2766] 1.1.29.15 getEmailNotification

[2767] public boolean getEmailNotification ( )

[2768] throws AuthorizationException, ConnectionException

[2769] Returns the email notification status that will be used when theassociated Item reaches this PublicationStatus.

[2770] Returns:

[2771] true if email notification is activated; false otherwise

[2772] Throws:

[2773]AuthorizationException—if the current user does not havepermission to perform this operation

[2774]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2775] 1.1.29.16 setSignOffToNewVersion

[2776] public void setSignOffToNewVersion(boolean signOffToNewVersion)

[2777] throws AuthorizationException, ConnectionException

[2778] When set to true, the associated Item will be assigned a newversion when it leaves this PublicationStatus.

[2779] Parameters:

[2780] signoffToNewversion—set to true to assign a new version to theassociated Item when it leaves this PublicationStatus; set to false tokeep the same version at signoff

[2781] Throws:

[2782]AuthorizationException—if the current user does not havepermission to perform this operation

[2783]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2784] 1.1.29.17 getSignOffToNewVersion

[2785] public boolean getSignOffToNewVersion ( )

[2786] throws AuthorizationException, ConnectionException

[2787] Return true if the associated Item will be assigned a new versionwhen it leaves this PublicationStatus.

[2788] Returns:

[2789] true if new version is going to be assigned to the associatedItem when it leaves this PublicationStatus; false if the Item will keepthe same version at signoff

[2790] Throws:

[2791]AuthorizationException—if the current user does not havepermission to perform this operation

[2792]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2793] 1.1.29.18 addGroupToNotify

[2794] public void addGroupToNotify(CmsUserGroup group)

[2795] throws AuthorizationException, ConnectionException

[2796] Adds a CmsUserGroup to the list of groups that are notified whenan item reaches this status. If the group is already being notified,this method does nothing but will not complain.

[2797] Parameters:

[2798] group—the group to be notified when an item reaches this status

[2799] Throws:

[2800]AuthorizationException—if the current user does not havepermission to perform this operation

[2801]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2802] 1.1.29.19 removeGroupToNotify

[2803] public void removeGroupToNotify(CmsUserGroup group)

[2804] throws AuthorizationException, ConnectionException

[2805] Removes a CmsUserGroup from the list of groups that are notifiedwhen an item reaches this status.

[2806] Parameters:

[2807] group—the group to no longer be notified when an item reachesthis status

[2808] Throws:

[2809]AuthorizationException—if the current user does not havepermission to perform this operation

[2810]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2811] 1.1.29.20 getGroupsToNotify

[2812] public java.util.Set getGroupsToNotify ( )

[2813] throws AuthorizationException, ConnectionException

[2814] Provides the set of all the CmsUserGroupS that are sentnotification when an item reaches this status.

[2815] Returns:

[2816] the set of groups that are notified when an item reaches thisstatus

[2817] Throws:

[2818]AuthorizationException—if the current user does not havepermission to perform this operation

[2819]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

1.1.30 INTERFACE PUBLICATIONSTATUSFACTORY

[2820] public interface PublicationStatusFactory

[2821] Interacts with the CMS to provide access to publication statii ofthe CMS. Method Summary PublicationStatus createNewPublicationStatus( )Creates a new PublicationStatus instance, uninitialized, not stored inthe CMS. void deletePublicationStatus(PublicationStatuspublicationStatus) Deletes this PublicationStatus. java.util.SetgetPublicationStatii( ) Provides the set of all PublicationStatuses.java.util.List getPublicationStatii(ItemType type) Provides the List ofall PublicationStatus for the specified type. PublicationStatusgetPublicationStatus (com.conceptis.util.PrimaryKey key) Provides thePublicationStatus with the specified key. voidsavePublicationStatus(PublicationStatus publicationStatus) Saves thespecified PublicationStatus.

Method Detail

[2822] 1.1.30.1 getPublicabonStatii

[2823] public java.util.Set getPublicationStatii ( )

[2824] throws ConnectionException, AuthorizationException

[2825] Provides the set of all PublicationStatuses.

[2826] Returns:

[2827] the set of all PublicationStatuses

[2828] Throws:

[2829]ConnectionException—if there is a problem interacting with the CMS

[2830]AuthorizationException—if the current user does not havepermission to perform this operation

[2831] 1.1.30.2 getPublicationStatii

[2832] public java.util.List getPublicationStatii(ItemType type)

[2833] throws ConnectionException, AuthorizationException

[2834] Provides the List of all PublicationStatus for the specifiedtype. Authorization required: Action.READ on the supplied ItemType

[2835] Parameters:

[2836] type—the type to provide the statii for

[2837] Returns:

[2838] the List of status objects associated with the provided type

[2839] Throws:

[2840]Connection Exception—if there is a problem interacting with theCMS

[2841]AuthorizationException—if the user does not have permission toperform this operation

[2842] 1.1.30.3 getPublicationStatus

[2843] public PublicationStatus

[2844] getPublicationStatus(com.conceptis.util.PrimaryKey key)

[2845] throws ConnectionException, AuthorizationException,MissingResourceException

[2846] Provides the PublicationStatus with the specified key.

[2847] Parameters:

[2848] key—the primary key of the PublicationStatus

[2849] Returns:

[2850] the PublicationStatus with the specified key

[2851] Throws:

[2852]ConnectionException—if there is a problem interacting with the CMS

[2853]AuthorizationException—if the current user does not havepermission to perform this operation

[2854]MissingResourceException—if the PublicationStatus specified by thekey does not exist

[2855] 1.1.30.4 createNewPublicationStatus

[2856] public PublicationStatus createNewPublicationStatus ( )

[2857] Creates a new PublicationStatus instance, uninitialized, notstored in the CMS. Once correctly initialized, this instance may then beinserted in the CMS using thesavePublicationStatus(com.conceptis.cms.PublicationStatus) method.

[2858] Returns:

[2859] the newly created PublicationStatus

[2860] 1.1.30.5 savePublicationStatus

[2861] public void savePublicationStatus(PublicationStatuspublicationStatus)

[2862] throws ConnectionException, AuthorizationException,MissingResourceException

[2863] Saves the specified PublicationStatus. This will change thePublicationStatus' entry in the CMS to reflect the state of thepublicationstatus parameter.

[2864] Parameters:

[2865] publicationstatus—the PublicationStatus to insert/update

[2866] Throws:

[2867]ConnectionException—if there is a problem interacting with the CMS

[2868]AuthorizationException—if the current user does not havepermission to perform this operation

[2869]MissingResourceException—if a previously existingPublicationStatus does not exist any longer

[2870] 1.1.30.6 deletePublicationStatus

[2871] public void deletePublicationStatus (PublicationStatuspublicationStatus)

[2872] throws ConnectionException, AuthorizationException,MissingResourceException

[2873] Deletes this PublicationStatus. This may have unintendedconsequences. Note that some implementations may throw anUnsupportedoperationException if the deletion of Publicationstatuses isnot possible.

[2874] Parameters:

[2875] publicationstatus—the PublicationStatus to delete

[2876] Throws:

[2877]ConnectionException—if there is a problem interacting with the CMS

[2878]AuthorizationException—if the current user does not havepermission to perform this operation

[2879]MissingResourceException—if the PublicationStatus does not existany longer

1.1.31 INTERFACE PUBLISHINGFLOW

[2880] All Superinterfaces:

[2881]ObjectWithPrimaraKey

[2882] public interface PublishingFlow

[2883] extends ObjectWithPrimaryKey

[2884] A PublishingFlow describes a sequence, order and relations, ofany number of PublicationStatus. Such a flow can be assigned to anItemType to constrain its publishing flow. Method Summary voidaddPublicationStatus(int index, PublicationStatus publicationStatus)Adds a PublicationStatus to this PublishingFlow at the specified index.java.lang.String getName( ) Returns the name of this PublishingFlow.java.util.List getPublicationStatii( ) Provides the PublicStatus objectsthat make up this flow. PublicationStatus getPublicationStatus(intindex) Returns the PublicationStatus found at the specified index inthis PublishingFlow. boolean isCircular( ) Returns true if thisPublicationFlow is circular; false otherwise. PublicationStatusremovePublicationStatus(PublicationStatus publicationStatus) Removes thePublicationStatus found at the specified index in this PublishingFlow.void setCircular(boolean circular) If set to true, this PublishingFlowwill be circular, which means that once the last PublicationStatus isreached and the Item is being signed off, it will start over at thefirst PublicationStatus. void setName(java.lang.String name) Sets thename of this PublishingFlow.

[2885] Methods inherited from interfacecom.conceptis.cms.ObjectWithPrimaryKey

[2886] get PrimaryKey

Method Detail

[2887] 1.1.31.1 setName

[2888] public void setName(java.lang.String name)

[2889] throws AuthorizationException, ConnectionException

[2890] Sets the name of this PublishingFlow.

[2891] Parameters:

[2892] name—the name of this PublishingFlow

[2893] Throws:

[2894]AuthorizationException—if the current user does not havepermission to perform this operation

[2895]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2896] 1.1.31.2 getName

[2897] public java.lang.String getName ( )

[2898] throws AuthorizationException, ConnectionException

[2899] Returns the name of this PublishingFlow.

[2900] Returns:

[2901] the name of this PublishingFlow

[2902] Throws:

[2903]AuthorizationException—if the current user does not havepermission to perform this operation

[2904]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2905] 1.1.31.3 addPublicaflonStatus

[2906] public void addPublicationStatus(int index, PublicationStatuspublicationStatus)

[2907] throws AuthorizationException, ConnectionException,java.lang.IndexOutPfBoundsException

[2908] Adds a PublicationStatus to this PublishingFlow at the specifiedindex.

[2909] Parameters:

[2910] index—index at which the PublicationStatus is to be insertedpublicationstatus—PublicationStatus to insert in the PublishingFlow

[2911] Throws:

[2912]AuthorizationException—if the current user does not havepermission to perform this operation

[2913]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2914] java.lang.IndexOutOfBoundsException—if the index is negative orlarger then the current field count

[2915] 1.1.31.4 getPublicabonStatus

[2916] public PublicationStatus getPublicationStatus(int index)

[2917] throws AuthorizationException, ConnectionException,java.lang.IndexOutOfBoundsException

[2918] Returns the PublicationStatus found at the specified index inthis PublishingFlow.

[2919] Parameters:

[2920] index—index at which the PublicationStatus is stored

[2921] Returns:

[2922] the PublicationStatus found at the specified index

[2923] Throws:

[2924]AuthorizationException—if the current user does not havepermission to perform this operation

[2925]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2926] java. lang. IndexOutOfBoundsException—if the index is negative orlarger then the current field count

[2927] 1.1.31.5 removePublicationStatus

[2928] public PublicationStatus

[2929] removePublicationStatus(PublicationStatus publicationStatus)

[2930] throws AuthorizationException, ConnectionException

[2931] Removes the PublicationStatus found at the specified index inthis PublishingFlow.

[2932] Parameters:

[2933] publicationStatus—the PublicationStatus to remove

[2934] Returns:

[2935] the removed PublicationStatus

[2936] Throws:

[2937]AuthorizationException—if the current user does not havepermission to perform this operation

[2938]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[2939] 1.1.31.6 getPublicationStatii

[2940] public java.util.List getPublicationStatii ( )

[2941] throws AuthorizationException, ConnectionException

[2942] ProvidesthePublicstatus objects that make up this flow. Theseobjects are returned in a List in the order of the publication flow.There may be duplicate elements.

[2943] Returns:

[2944] the publication statii, in order of flow

[2945] Throws:

[2946]AuthorizationException—if the current user does not havepermission to perform this operation

[2947]ConnectionException—if there is a problem interacting with theCMS;

[2948] this will only be thrown if the driver implementation choses touse deferred data loading (for performance reason).

[2949] 1.1.31.7 setCircular

[2950] public void setCircular(boolean circular)

[2951] throws AuthorizationException, ConnectionException

[2952] If set to true, this PublishingFlow will be circular, which meansthat once the last PublicationStatus is reached and the Item is beingsigned off, it will start over at the first PublicationStatus.

[2953] Parameters:

[2954] circular—set to true for a circular behavior; set to false forsimple linear behavior

[2955] Throws:

[2956]AuthorizationException—if the current user does not havepermission to perform this operation

[2957]ConnectionException—if there is a problem interacting with theCMS;

[2958] this will only be thrown if the driver implementation choses touse deferred data loading (for performance reason).

[2959] 1.1.31.8 isCircular

[2960] public boolean isCircular ( )

[2961] throws AuthorizationException, ConnectionException

[2962] Returns true if this PublicationFlow is circular; falseotherwise.

[2963] Returns:

[2964] true if this PublicationFlow is circular; false otherwise

[2965] Throws:

[2966]AuthorizationException—if the current user does not havepermission to perform this operation

[2967]ConnectionException—if there is a problem interacting with theCMS;

[2968] this will only be thrown if the driver implementation choses touse deferred data loading (for performance reason).

1.1.32 INTERFACE PUBLISHINGFLOWFACTORY

[2969] public interface PublishingFlowFactory

[2970] Interacts with the CMS to provide access to publication flows ofthe CMS. Method Summary PublishingFlow createNewPublishingFlow( )Creates a new PublishingFlow instance, uninitialized, not stored in theCMS. void deletePublicationStatus(PublishingFlow publishingFlow) Deletesthis PublishingFlow. PublishingFlowgetPublishingFlow(com.conceptis.util.PrimaryKey key) Provides thePublishingFlow with the specified key. java.util.Set getPublishingFlows() Provides the set of all PublishingFlows. voidsavePublishingFlow(PublishingFlow publishingFlow) Saves the specifiedPublishingFlow.

Method Detail

[2971] 1.1.32.1 getPublishingFlows

[2972] public java.util.Set getPublishingFlows ( )

[2973] throws ConnectionException, AuthorizationException

[2974] Provides the set of all PublishingFlows.

[2975] Returns:

[2976] the set of all PublishingFlows

[2977] Throws:

[2978]ConnectionException—if there is a problem interacting with the CMS

[2979]AuthorizationException—if the current user does not havepermission to perform this operation

[2980] 1.1.32.2 getPublishingFIow

[2981] publicPublishingFlowgetPublishingFlow(com.conceptis.util.PrimaryKey key)

[2982] throws ConnectionException, AuthorizationException,MissingResourceException

[2983] Provides the PublishingFlow with the specified key.

[2984] Parameters:

[2985] key—the primary key of the PublishingFlow

[2986] Returns:

[2987] the PublishingFlow with the specified key

[2988] Throws:

[2989]ConnectionException—if there is a problem interacting with the CMS

[2990]AuthorizationException—if the current user does not havepermission to perform this operation

[2991]MissingResourceException—if the PublishingFlow specified by thekey does not exist

[2992] 1.1.32.3 createNewPublishingFlow

[2993] public PublishingFlow createNewPublishingFlow ( )

[2994] Creates a new PublishingFlow instance, uninitialized, not storedin the CMS. Once correctly initialized, this instance may then beinserted in the CMS using thesavePublishingFlow(com.conceptis.cms.PublishingFlow) method.

[2995] Returns:

[2996] the newly created PublishingFlow

[2997] 1.1.32.4 savePublishingFlow

[2998] public void savePublishingFlow(PublishingFlow publishingFlow)

[2999] throws ConnectionException, AuthorizationException,MissingResourceException

[3000] Saves the specified PublishingFlow. This will change thePublishingFlow's entry in the CMS to reflect the state of thepublishingFlow parameter.

[3001] Parameters:

[3002] publishingFlow—the PublishingFlow to insert/update

[3003] Throws:

[3004]ConnectionException—if there is a problem interacting with the CMS

[3005]AuthorizationException—if the current user does not havepermission to perform this operation

[3006]MissingResourceException—if a previously existing PublishingFlowdoes not exist any longer

[3007] 1.1.32.5 deletePublicationStatus

[3008] public void deletePublicationStatus(PublishingFlowpublishingFlow)

[3009] throws ConnectionException, AuthorizationException,MissingResourceException

[3010] Deletes this PublishingFlow. This may have unintendedconsequences. Note that some implementations may throw anUnsupportedoperationException if the deletion of PublishingFlowS is notpossible.

[3011] Parameters:

[3012] publishingFlow—the PublishingFlow to delete

[3013] Throws:

[3014]ConnectionException—if there is a problem interacting with the CMS

[3015]AuthorizationException—if the current user does not havepermission to perform this operation

[3016]MissingResourceException—if the PublishingFlow does not exist anylonger

1.1.33 INTERFACE RELATIONSHIP

[3017] public interface Relationship

[3018] Links an Item relationship with a List of parameters. MethodSummary java.util.Iterator getParameterNames() Provides names of theparamneters in this relationship. java.util.ListgetParameterValues(java.lang.String name) Provides the values of theparameter specified (a list of strings). Item getRaltion() Provides therelated item.

Method Detail

[3019] 1.1.33.1 getRelation

[3020] public Item getRelation ( )

[3021] throws ConnectionException, AuthorizationException,MissingResourceException

[3022] Provides the related item.

[3023] Returns:

[3024] the item that is in the relationship

[3025] Throws:

[3026]AuthorizationException—if the current user does not havepermission to perform this operation

[3027]ConnectionException—if there is a problem interacting with theCMS; this will only be thrown if the driver implementation choses to usedeferred data loading (for performance reason).

[3028]MissingResourceException—is the item in the relationship does notexist

[3029] 1.1.33.2 getParameterNames

[3030] public java.util.Iterator getParameterNames ( )

[3031] Provides names of the parameters in this relationship.

[3032] Returns:

[3033] the names of the parameters

[3034] 1.1.33.3 getParameterValues

[3035] public java.util.List getParametervalues(java.lang.String name)

[3036] Provides the values of the parameter specified (a list ofstrings).

[3037] Parameters:

[3038] name—tne name of tne parameter

[3039] Returns:

[3040] the values of the specified parameter (a list of strings)

1.1.34 INTERFACE RELATIONTYPE

[3041] public interface RelationType

[3042] A RelationType defines any kind of relation that may existbetween two Items: parent/child, article/author, text/image, etc.Relations may or may not be bilateral, meaning that a relation may becalled differently depending on the point of origin (ex: parent/child).Relations may also be of the following types: 1-to-1, 1-to-many ormany-to-many. Field Summary static java.lang.String CHILD Defines aRelationType that can be used to link non-unique child ItemS to anotherItem. static java.lang.String DESCENDANT Defines a RelationType that canbe used to link non-unique child ItemS to another Item. staticjava.lang.String PARENT Defines a RelationType that can be used to linknon-unique parent ItemS to another Item. static java.lang.String PRIMARYPARENT Defines a RelationType that can be used to link a unique parentItem to another Item. static java.lang.String SECONDARY PARENT Defines aRelationType that can be used to link a parent Item to another Item.Method Summary java.lang.String getName( ) Returns the name of thisRelationType. boolean isMandatory( ) Indicates whether the RelationTypemust be set. boolean isUnique( ) Returns true if the Item can only haveone unique Item linked to it using this RelationType; returns false ifan Item may have one or more other ItemS linked to it using thisRelationType.

Field Detail

[3043] 1.1.34.1 PRIMARY_PARENT

[3044] public static final java.lang.String PRIXARY_PARENT

[3045] Defines a RelationType that can be used to link a unique parentItem to another Item.

[3046] This is the reciprocal of CHILD.

[3047] See Also:

[3048]Constant Field Values

[3049] 1.1.34.2 PARENT

[3050] public static final java.lang.String PARENT

[3051] Defines a RelationType that can be used to link non-unique parentItems to another

[3052] Item. This is the reciprocal of CHILD.

[3053] See Also:

[3054]Constant Field Values

[3055] 1.1.34.3 SECONDARY_PARENT

[3056] public static final java.lang.String SECONDARY_PARENT

[3057] Defines a RelationType that can be used to link a parent Item toanother Item. This is the reciprocal of CHILD.

[3058] See Also:

[3059]Constant Field Values

[3060] 1.1.34.4 CHILD

[3061] public static final java.lang.String CHILD

[3062] Defines a RelationType that can be used to link non-unique childItems to another Item. This is the reciprocal of PRIMARY PARENT andPARENT.

[3063] See Also:

[3064]Constant Field Values

[3065] 1.1.34.5 DESCENDANT

[3066] public static final java.lang.String DESCENDANT

[3067] Defines a RelationType that can be used to link non-unique childItems to another Item.

[3068] See Also:

[3069]Constant Field Values

Method Detail

[3070] 1.1.34.6 getName

[3071] public java.lang.String getName ( )

[3072] Returns the name of this RelationType.

[3073] Returns:

[3074] the name of this RelationType

[3075] 1.1.34.7 isUnique

[3076] public boolean isUnique ( )

[3077] Returns true if the Item can only have one unique Item linked toit using this RelationType; returns false if an Item may have one ormore other Items linked to it using this RelationType.

[3078] Returns:

[3079] true for unique linked Item; false for multiple linked Items

[3080] 1.1.34.8 isMandatory

[3081] public boolean isMandatory ( )

[3082] Indicates whether the RelationType must be set.

[3083] Returns:

[3084] true if the relation is mandatory, false otherwise

1.1.35 INTERFACE RELATIONTYPEFACTORY

[3085] public interface RelationTypeFactory

[3086] Interacts with the CMS to provide access to the relation types ofthe CMS. Method Summary RelationType getRelationType(ItemType type,java.lang.String name) Provides the RelationType with the specified nameand uniqueness. RelationType getRelationType(java.lang.String type,java.lang. String name) Provides the RelationType with the specifiedname and uniqueness. java.util.Set getRelationTypes(ItemType type)Provides the set of all RelationTypeS. booleanrelationshipPermitted(java.lang.String itemType1, java.lang.StringitemType2, java.lang.String name) Indicates whether two items arelinkable.

Method Detail

[3087] 1.1.35.1 getRelationTypes

[3088] public java.util.Set getRelationTypes(ItemType type)

[3089] throws ConnectionException, AuthorizationException

[3090] Provides the set of all RelationTypes.

[3091] Parameters:

[3092] type—the ItemType of the item seeking a list of possiblerelationship types

[3093] Returns:

[3094] the set of all RelationTypes (may be empty but never null)

[3095] Throws:

[3096]ConnectionException—if there is a problem interacting with the CMS

[3097]AuthorizationException—if the current user does not havepermission to perform this operation

[3098] 1.1.35.2 getRelationType

[3099] public RelationType getRelationType(ItemType type,java.lang.String name)

[3100] throws ConnectionException, AuthorizationException,MissingResourceException

[3101] Provides the RelationType with the specified name and uniqueness.

[3102] Parameters:

[3103] type—the ItemType of the item seeking a relationship

[3104] name—the name of the relation

[3105] Returns:

[3106] the RelationType matching the specified parameters

[3107] Throws:

[3108]ConnectionException—if there is a problem interacting with the CMS

[3109]AuthorizationException—if the current user does not havepermission to perform this operation

[3110]MissingResourceException—if the RelationType specified by theparameters does not exist

[3111] 1.1.35.3 getRelationType

[3112] public RelationType getRelationType(java.lang.String type,java.lang.String name)

[3113] throws ConnectionException, AuthorizationException,MissingResourceException

[3114] Provides the RelationType with the specified name and uniqueness.

[3115] Parameters:

[3116] type—the name of ItemType of the item seeking a relationship

[3117] name—the name of the relation

[3118] Returns:

[3119] the RelationType matching the specified parameters

[3120] Throws:

[3121]ConnectionException—if there is a problem interacting with the CMS

[3122]AuthorizationException—if the current user does not havepermission to perform this operation

[3123]MissingResourceException—if the RelationType specified by theparameters does not exist, or the ItemType does not exist

[3124] 1.1.35.4 relationshipPermitted

[3125] public boolean relationshipPermitted(java.lang.string itemType1,java.lang.String itemType2, java.lang.String name)

[3126] throws ConnectionException, AuthorizationException,MissingResourceException

[3127] Indicates whether two items are linkable.

[3128] Parameters:

[3129] itemType1—the first item type

[3130] itemType2—the second item type

[3131] name—the name of the relationship

[3132] Returns:

[3133] true if the items are linkable, false otherwise

[3134] Throws:

[3135]ConnectionException—if there is a problem interacting with the CMS

[3136]AuthorizationException—if the current user does not havepermission to perform this operation

[3137]MissingResourceException—if the RelationType specified by theparameters does not exist, or the ItemType does not exist

1.1.36 INTERFACE SECURITYMANAGER

[3138] public interface SecurityManager

[3139] The SecurityManager centralizes all the business logic of yourdriver related to access restrictions. Indeed, most of the actions thatcan be performed by a CmsUser when using the CMS Driver may need to beapproved before being executed.

[3140] This Interface must be implemented by your application in orderto define your own business logic, and you must then tell the driverthat you will use your own implementation using the driver configurationfile. Method Summary boolean isAllowed(CmsUser cmsUser, Action action,Item item, Field field) This feature is not supported in this version ofthe CMS API, and will always throw an UnsupportedOperationException.boolean isAllowed(CmsUser cmsUser, Action action, java.lang. Objectresource) Checks if the CmsUser can perform the Action on the givenSecureResource.

Method Detail

[3141] 1.1.36.1 isAllowed

[3142] public boolean isAllowed(CmsUser cmsUser, Action action,java.lang.object resource)

[3143] Checks if the CmsUser can perform the Action on the givenSecureResource.

[3144] Parameters:

[3145] CmsUser—the CmsUser that wants to execute the specified Action onthe given resource.

[3146] action—the Action that will be performed by the CmsUser on thegiven resource, if authorized.

[3147] resource—the Object on which the specified Action will beperformed if authorization is granted.

[3148] Returns:

[3149] true if the given CmsUser has enough credentials to perform theaction on the resource.

[3150] 1.1.36.2 isAllowed

[3151] public boolean isAllowed(CmsUser cmsUser, Action action, Itemitem, Field field)

[3152] This feature is not supported in this version of the CMS API, andwill always throw an UnsupportedOperationException.

[3153] Checks if the CmsUser can perform the Action on the Field of thegiven Item.

[3154] Parameters:

[3155] cmsUser—the CmsUser that wants to execute the specified action onthe given Item.

[3156] action—the Action that will be performed by the CmsUser on thegiven Item, if authorized.

[3157] item—the Item on which the specified Action will be performed ifauthorization is granted.

[3158] field—the Field of the Item that will be accessed when performingthe specified action.

[3159] Returns:

[3160] true if the given CmsUser has enough credentials to perform theAction on the Field of the Item.

1.1.37 INTERFACE VERSION

[3161] public interface Version

[3162] A Version represents a modification applied to an Item. MethodSummary CmsUser getAuthor( ) Returns the Author of this Version.java.util.Date getDate( ) Returns the Date of this Version.java.lang.String getNote( ) Return the text note associated with thisVersion. PublicationStatus getPublicationStatus( ) Returns thePublicationStatus of this Version. long getVersion( ) Returns thecurrent version number of this Version.

Method Detail

[3163] 1.1.37.1 getVersion

[3164] public long getVersion ( )

[3165] throws AuthorizationException

[3166] Returns the current version number of this Version.

[3167] Returns:

[3168] the current version number of this Version

[3169] Throws:

[3170]AuthorizationException—if the user does not have permission toperform this operation

[3171] 1.1.37.2 getNote

[3172] public java.lang.String getNote ( )

[3173] throws AuthorizationException

[3174] Return the text note associated with this Version.

[3175] Returns:

[3176] the text note associated with this Version

[3177] Throws:

[3178]AuthorizationException—if the user does not have permission toperform this operation

[3179] 1.1.37.3 getPublicabonStatus

[3180] public PublicationStatus getPublicationStatus ( )

[3181] throws AuthorizationException

[3182] Returns the PublicationStatus of this Version.

[3183] Returns:

[3184] the PublicationStatus of this Version

[3185] Throws:

[3186]AuthorizationException—if the user does not have permission toperform this operation

[3187] 1.1.37.4 getAuthor

[3188] public CmsUser getAuthor ( )

[3189] throws AuthorizationException

[3190] Returns the Author of this Version.

[3191] Returns:

[3192] the Author of this Version

[3193] Throws:

[3194]AuthorizationException—if the user does not have permission toperform this operation

[3195] 1.1.37.5 getDate

[3196] public java.util.Date getDate ( )

[3197] throws AuthorizationException

[3198] Returns the Date of this Version.

[3199] Returns:

[3200] the Date of this Version

[3201] Throws:

[3202]AuthorizationException—if the user does not have permission toperform this operation

1.2 PACKAGE COM.CONCEPTIS.CMS.FILTER 1.2.1 CLASSCMSUSERUSERNAMECOMPARATOR

[3203]

[3204] All Implemented Interfaces:

[3205] java.util.Comparator

[3206] public class CmsUserUsernameComparator

[3207] extends java.lang.Object

[3208] implements java.util.Comparator

[3209] Comparator that utilizes a User's username to sort a collectionof users. Field Summary private boolean ascending Whether to sortascending or descending. private log static org.apache.log4j.Logger Forlogging purposes.

Constructor Summary

[3210]CmsUserUsernameComparator ( ) Method Summary intcompare(java.lang.Object o1, java.lang.Object o2) Compares its twoarguments for order. boolean isAscending( ) Indicates whether thecomparator is sorting in an ascending or descending manner. voidsetAscending(boolean ascending) Sets whether the comparator is sortingin an ascending or descending manner.

[3211] Methods inherited from class java.lang.Object

[3212] clone, equals, finalize, getclass, hashCode, notify, notifyAll,toString, wait, wait, wait

[3213] Methods inherited from interface java.util.Comparator

[3214] equals

Field Detail

[3215]1.2.1.1 log

[3216] private static org.apache.log4j.Logger log

[3217] For logging purposes.

[3218] 1.2.1.2 ascending

[3219] private boolean ascending

[3220] Whether to sort ascending or descending.

Constructor Detail

[3221] 1.2.1.3 CmsUserUsernameComparator

[3222] public CmsUserUsernameComparator ( )

Method Detail

[3223] 1.2.1.4 isAscending

[3224] public boolean isAscending ( )

[3225] Indicates whether the comparator is sorting in an ascending ordescending manner.

[3226] Returns:

[3227] true if the comparator is ascending, false if descending

[3228] 1.2.1.5 setAscending

[3229] public void setAscending(boolean ascending)

[3230] Sets whether the comparator is sorting in an ascending ordescending manner.

[3231] Parameters:

[3232] ascending—true if the comparator is ascending, false otherwise

[3233] 1.2.1.6 compare

[3234] public int compare(java.lang.object o1, java.lang.object o2)

[3235] throws java.lang.ClassCastException

[3236] Compares its two arguments for order. Returns a negative integer,zero, or a positive integer as the first argument is less than, equalto, or greater than the second.

[3237] Specified by:

[3238] compare in interface java.util. Comparator

[3239] Parameters:

[3240] o1—the first object to be compared

[3241] o2—the second object to be compared

[3242] Returns:

[3243] a negative integer, zero, or a positive integer as the firstargument is less than, equal to, or greater than the second

[3244] Throws:

[3245] java.lang.ClassCastException—if the arguments' types prevent themfrom being compared by this Comparator

1.2.2 CLASS DATEAWAREITEMNAMECOMPARATOR

[3246]

[3247] All Implemented Interfaces:

[3248] java.util.Comparator

[3249] public class DateAwareItemNameComparator

[3250] extends java.lang.Object

[3251] implements java.util.Comparator

[3252] Comparator that is able to compare an Item's names. If there is adate in the name, this is used to sort, but in reverse order (so,alphabetically ascending, but numerically descending, or the opposite).Field Summary private boolean dateAscending The order to sort the date.private boolean nameAscending The order to sort the name. privatepattern static java.util.regex.Pattern The compiled pattern. staticjava.lang.String YEAR PATTERN The pattern to recognize years.

Constructor Summary

[3253]DateAwareItemNameComparator ( )

[3254] Creates a comparator that sorts the name ascending, datedescending.

[3255]DateAwareItemNameComparator(boolean nameAscending, booleandateAscending)

[3256] Creates a comparator. Method Summary int compare(java.lang.Obiecto1, java.lang.Object o2) Compares two objects, which may be ItemS orDateS.

[3257] Methods inherited from class java.lang.Object

[3258] clone, equals, finalize, getClass, hashCode, notify, notifyAll,toString, wait, wait, wait

[3259] Methods inherited from interface java.util.Comparator

[3260] equals

Field Detail

[3261] 1.2.2.1 nameAscending

[3262] private boolean nameAscending

[3263] The order to sort the name.

[3264] 1.2.2.2 dateAscending

[3265] private boolean dateAscending

[3266] The order to sort the date.

[3267] 1.2.2.3 YEAR_PATTERN

[3268] public static final java.lang.String YEAR_PATTERN

[3269] The pattern to recognize years.

[3270] See Also:

[3271] Constant Field Values

[3272] 1.2.2.4 pattern

[3273] private static java.util.regex.Pattern pattern

[3274] The compiled pattern.

Constructor Detail

[3275] 1.2.2.5 DateAwareItemNameComparator

[3276] public DateAwareItemNameComparator ( )

[3277] Creates a comparator that sorts the name ascending, datedescending.

[3278] 1.2.2.6 DateAwareItemNameComparator

[3279] public DateAwareItemNameComparator(boolean nameAscending, booleandateAscending)

[3280] Creates a comparator.

[3281] Parameters:

[3282] nameAscending—true to sort the name ascending, false descending

[3283] dateAscending—true to sort the date ascending, false descending

Method Detail

[3284] 1.2.2.7 compare

[3285] public int compare(java.lang.Object o1, java.lang.Object o2)

[3286] throws java.lang.ClassCastException

[3287] Compares two objects, which may be Items or Dates.

[3288] Specified by:

[3289] compare in interface java.util.Comparator

[3290] Parameters:

[3291] o1—the first object to compare

[3292] o2—the second object to compare

[3293] Returns:

[3294] a negative integer, zero, or a positive integer as the firstargument is less than, equal to, or greater than the second

[3295] Throws:

[3296] java.lang.ClassCastException—if the arguments' types prevent themfrom being compared by this Comparator

1.2.3 CLASS ITEMDATERANGEFILTER

[3297]

[3298] All Implemented Interfaces:

[3299] com.conceptis.util.filter.Filter

[3300] Direct Known Subclasses:

[3301]ItemFieldDateRangeFilter, ItemLastModificationDateFilter

[3302] public class ItemDateRangeFilter

[3303] extends com.conceptis.util.filter.RangeFilter

[3304] Filters a Collection of Items using a date range. Field Summarystatic java.lang.String DEFAULT PATTERN The default (SimpleDateFormatpattern for interpreting dates: dd MM yyyy HH:mm:ss. private formatjava.text.SimpleDateFormat The SimpleDateFormat used to interpret dates.private java.util.Locale locale The locale used to interpret dates.private localeRegex static java.util.regex.Pattern The regularexpression to parse the Locale string. private log staticorg.apache.log4j.Logger For logging purposes. private java.lang.Stringpattern The pattern used to interpret dates.

[3305] Fields inherited from class com.conceptis.util.filter.RangeFilter

Constructor Summary

[3306]ItemDateRangeFilter ( ) Method Summary java.lang.StringgetEndDate( ) Provides the ending date range. java.lang.StringgetLocale( ) Provide the locale used to interpret dates.java.lang.String getPattern( ) Provides the pattern used to interpretdates. java.lang.String getStartDate( ) Provides the starting daterange. java.util.Locale parseLocale(java.lang.String locale) Generates alocale from a string provided be a locale's toString method. voidsetEndDate(java.lang.String end) Sets the ending date range. voidsetLocale(java.lang.String locale) Sets the locale used to interpretdates. void setPattern(java.lang.String pattern) Sets the pattern usedto interpret dates. void setStartDate(java.lang.String start) Sets thestarting date range.

[3307] Methods inherited from classcom.conceptis.util.filter.RangeFilter

[3308] filter, getComparator, getEnd, getStart, isInclusive, isInside,setComparator, setEnd, setInclusive, setInside, setStart

[3309] Methods inherited from classcom.conceptis.util.filter.AbstractFilter

[3310] filter

[3311] Methods inherited from class java.lang.Object

[3312] clone, equals, finalize, getClass, hashCode, notify, notifyAll,toString, wait, wait, wait

Field Detail

[3313] 1.2.3.1 DEFAULT_PATTERN

[3314] public static final java.lang.String DEFAULT_PATTERN

[3315] The default (SimpleDateFormat pattern for interpreting dates: ddMM yyyy HH:mm:ss.

[3316] See Also:

[3317]Constant Field Values

[3318] 1.2.3.2 localeRegex

[3319] private static java.util.regex.Pattern localeRegex

[3320] The regular expression to parse the Locale string.

[3321] 1.2.3.3 log

[3322] private static org.apache.log4j.Logger log

[3323] For logging purposes.

[3324] 1.2.3.4 locale

[3325] private java.util.Locale locale

[3326] The locale used to interpret dates.

[3327] 1.2.3.5 pattern

[3328] private java.lang.String pattern

[3329] The pattern used to interpret dates.

[3330] 1.2.3.6 format

[3331] private java.text.SimpleDateFormat format

[3332] The SimpleDateFormat used to interpret dates.

Constructor Detail

[3333] 1.2.3.7 ItemDateRangeFilter

[3334] public ItemDateRangeFilter ( )

Method Detail

[3335] 1.2.3.8 getLocale

[3336] public java.lang.String getLocale ( )

[3337] Provide the locale used to interpret dates.

[3338] Returns:

[3339] the locale used to interpret dates

[3340] 1.2.3.9 setLocale

[3341] public void setLocale(java.lang.String locale)

[3342] Sets the locale used to interpret dates.

[3343] Parameters:

[3344] locale—the locale used to interpret dates

[3345] 1.2.3.10 parseLocale

[3346] public java.util.Locale parseLocale(java.lang.String locale)

[3347] Generates a locale from a string provided be a locale's toStringmethod.

[3348] Parameters:

[3349] locale—a string representing a locale

[3350] Returns:

[3351] a locale as specified by the string

[3352] 1.2.3.11 getPattern

[3353] public java.lang.String getPattern ( )

[3354] Provides the pattern used to interpret dates.

[3355] Returns:

[3356] the pattern used to interpret dates

[3357] 1.2.3.12 setPattern

[3358] public void setPattern(java.lang.String pattern)

[3359] Sets the pattern used to interpret dates.

[3360] Parameters:

[3361] pattern—the pattern to use

[3362] 1.2.3.13 getStartDate

[3363] public java.lang.String getStartDate ( )

[3364] Provides the starting date range.

[3365] Returns:

[3366] the starting date range

[3367] 1.2.3.14 setStartDate

[3368] public void setStartDate(java.lang.String start)

[3369] throws java.text.ParseException

[3370] Sets the starting date range.

[3371] Parameters:

[3372] start—the starting date range

[3373] Throws:

[3374] java.text.ParseException—if the date cannot be parsed

[3375] 1.2.3.15 getEndDate

[3376] public java.lang.String getEndDate ( )

[3377] Provides the ending date range.

[3378] Returns:

[3379] the ending date range

[3380] 1.2.3.16 setEndDate

[3381] public void setEndDate(java.lang.String end)

[3382] throws java.text.ParseException

[3383] Sets the ending date range.

[3384] Parameters:

[3385] end—the ending date range

[3386] Throws:

[3387] java.text.ParseException—if the date cannot be parsed

1.2.4 CLASS ITEMFIELDDATECOMPARATOR

[3388]

[3389] All Implemented Interfaces:

[3390] java.util.Comparator

[3391] public class ItemFieldDateComparator

[3392] extends java.lang.Object

[3393] implements java.util.Comparator

[3394] Comparator that is able to compare an Item's field value to aDate. Field Summary private java.lang.String fieldName The field name tocompare to. private log static org.apache.log4j.Logger For loggingpurposes.

Constructor Summary

[3395]ItemFieldDateComparator ( ) Method Summary intcompare(java.lang.Object o1, java.lang.Object o2) Compares two objects,which may be ItemS or DateS. java.lang.String getFieldName( ) Providesthe field name to use in the comparison. voidsetFieldName(java.lang.String fieldName) Sets the field name to use inthe comparison.

[3396] Methods inherited from class java.lang.Object

[3397] clone, equals, finalize, getClass, hashCode, notify, notifyAll,toString, wait, wait, wait

[3398] Methods inherited from interface java.util.Comparator

[3399] equals

Field Detail

[3400] 1.2.4.1 log

[3401] private static org.apache.log4j.Logger log

[3402] For logging purposes.

[3403] 1.2.4.2 fieldName

[3404] private java.lang.String fieldName

[3405] The field name to compare to.

Constructor Detail

[3406] 1.2.4.3 ItemFieldDateComparator

[3407] public ItemFieldDateComparator ( )

Method Detail

[3408] 1.2.4.4 getFieldName

[3409] public java.lang.String getFieldName ( )

[3410] Provides the field name to use in the comparison.

[3411] Returns:

[3412] the field name to use in the comparison

[3413] 1.2.4.5 setFieldName

[3414] public void setFieldName(java.lang.String fieldName)

[3415] Sets the field name to use in the comparison.

[3416] Parameters:

[3417] fieldName—the fieldName to use in the comparison

[3418] 1.2.4.6 compare

[3419] public int compare(java.lang.Object o1, java.lang.Object o2)

[3420] throws java.lang.ClassCastException

[3421] Compares two objects, which may be Items or Dates.

[3422] Specified by:

[3423] compare in interface java.util. Comparator

[3424] Parameters:

[3425] o1—the first object to compare

[3426] o2—the second object to compare

[3427] Returns:

[3428] a negative integer, zero, or a positive integer as the firstargument is less than, equal to, or greater than the second

[3429] Throws:

[3430] java. lang. ClasscastException—if the arguments' types preventthem from being compared by this Comparator

1.2.5 CLASS ITEMFIELDDATERANGEFILTER

[3431]

[3432] All Implemented Interfaces:

[3433] com.conceptis.util.filter.Filter

[3434] public class ItemFieldDateRangeFilter

[3435] extends ItemDateRangeFilter

[3436] Filters a Collection of Items using a date field and a range ofdates.

Field Summary

[3437] Fields inherited from classcom.conceptis.cms.filter.ItemDateRangeFilter

[3438]DEFAULT PATTERN

Constructor Summary

[3439]ItemFieldDateRang Filter ( ) Method Summary java.lang.StringgetFieldName( ) Provides the fieldName being used to filter the results.void setFieldName(java.lang.String fieldName) Sets the fieldName to use.

[3440] Methods inherited, from classcom.conceptis.cms.filter.ItemDateRangeFilter

[3441]getEndDate, getLocale, getpattern, getStartDate, parseLocale,setEndDate, setLocale, setPattern, setStartDate

[3442] Methods inherited from classcom.conceptis.util.filter.RangeFilter

[3443] filter, getComparator, getEnd, getStart, isInclusive, isInside,setComparator, setEnd, setInclusive, setInside, setStart

[3444] Methods inherited from classcom.conceptis.util.filter.AbstractFilter

[3445] filter

[3446] Methods inherited from class java.lang.Object

[3447] clone, equals, finalize, getClass, hashCode, notify, notifyAll,toString, wait, wait, wait

Constructor Detail

[3448] 1.2.5.1 ItemFieldDateRangeFilter

[3449] public ItemFieldDateRangeFilter ( )

Method Detail

[3450] 1.2.5.2 getFieldName

[3451] public java.lang.String getFieldName ( )

[3452] Provides the fieldName being used to filter the results.

[3453] Returns:

[3454] the fieldName being used to filter the results

[3455] 1.2.5.3 setFieldName

[3456] public void setFieldName(java.lang.String fieldName)

[3457] Sets the fieldName to use.

[3458] Parameters:

[3459] fieldName—the fieldName to use

1.2.6 CLASS ITEMFIELDREGEXFILTER

[3460]

[3461] All Implemented Interfaces:

[3462] com.conceptis.util.filter.Filter

[3463] public class ItemFieldRegexFilter

[3464] extends com.conceptis.util.filter.AbstractFilter

[3465] Filters a Collection of Items using a field of the item, andmatching it with a regular expression. Field Summary privatejava.lang.String fieldName The field name used for filtering. privatelog static org.apache.log4j.Logger For logging purposes. private patternjava.util.regex.Pattern The Pattern used for filtering. privatejava.lang.String regexp The regular expression used for filtering.

Constructor Summary

[3466]ItemFieldRegexFilter ( ) Method Summary booleanfilter(java.lang.Object obj) Indicates whether an Object passes thisfilter. java.lang.String getFieldName( ) Provides the name of the fieldbeing filtered on. java.lang.String getRegexp( ) Provides the regularexpression used for filtering. void setFieldName(java.lang.StringfieldName) Sets the name of the field being filtered on. voidsetRegexp(java.lang.String regexp) Sets the regular expression used forfiltering.

[3467] Methods inherited from classcom.conceptis.util.filter.AbstractFilter

[3468] filter

[3469] Methods inherited from class java.lang.Object

[3470] clone, equals, finalize, getClass, hashCode, notify, notifyAll,toString, wait, wait, wait

Field Detail

[3471] 1.2.6.1 log

[3472] private static org.apache.log4j.Logger log

[3473] For logging purposes.

[3474] 1.2.6.2 fieldName

[3475] private java.lang.String fieldName

[3476] The field name used for filtering.

[3477] 1.2.6.3 regexp

[3478] private java.lang.String regexp

[3479] The regular expression used for filtering.

[3480] 1.2.6.4 pattern

[3481] private java.util.regex.Pattern pattern

[3482] The Pattern used for filtering.

Constructor Detail 1.2.7 ITEMFIELDREGEXFILTER

[3483] public ItemFieldRegexFilter ( )

Method Detail

[3484] 1.2.7.1 filter

[3485] public boolean filter(java.lang.object obj)

[3486] Indicates whether an Object passes this filter.

[3487] Parameters:

[3488] obj—the object to pass through the filter.

[3489] Returns:

[3490] true if the object passes, false otherwise

[3491] 1.2.7.2 getFieldName

[3492] public java.lang.String getFieldName ( )

[3493] Provides the name of the field being filtered on.

[3494] Returns:

[3495] the name of the field being filtered on

[3496] 1.2.7.3 setFieldName

[3497] public void setFieldName(java.lang.String fieldName)

[3498] Sets the name of the field being filtered on.

[3499] Parameters:

[3500] fieldName—the name of the field to filter on

[3501] 1.2.7.4 getRegexp

[3502] public java.lang.String getRegexp ( )

[3503] Provides the regular expression used for filtering.

[3504] Returns:

[3505] the regular expression used for filtering

[3506] 1.2.7.5 setRegexp

[3507] public void setRegexp(java.lang.String regexp)

[3508] throws java.util.regex.PatternSyntaxException

[3509] Sets the regular expression used for filtering.

[3510] Parameters:

[3511] regexp—the regular expression used for filtering

[3512] Throws:

[3513] java.util. regex. PatternSyntaxException—if the regularexpression could not be compiled

1.2.8 CLASS ITEMITEMTYPEFILTER

[3514]

[3515] All Implemented Interfaces:

[3516] com.conceptis.util.filter.Filter

[3517] public class ItemItemTypeFilter

[3518] extends com.conceptis.util.filter.AbstractFilter

[3519] Filters a Collection of Items using the ItemType. Field Summaryprivate boolean included Whether to include or exclude items of thetype. private log static org.apache.log4j.Logger For logging purposes.private java.lang.String type The name of the ItemType to filter on.

Constructor Summary

[3520]ItemItemTypeFilter ( ) Method Summary booleanfilter(java.lang.Object obj) indicates whether an Object passes thisfilter. java.lang.String getItemType( ) Provides the ItemType that isbeing used by the filter. boolean isIncluded( ) Indicates whether thefilter will include or exclude items of the specified type. voidsetIncluded(boolean included) Sets whether the filter will include orexclude items of the specified type. void setItemType(java.lang.Stringtype) Sets the ItemType to be used by the filter.

[3521] Methods inherited from classcom.conceptis.util.filter.AbstractFilter

[3522] filter

[3523] Methods inherited from class java.lang.Object

[3524] clone, equals, finalize, getClass, hashCode, notify, notifyAll,toString, wait, wait, wait

Field Detail

[3525] 1.2.8.1 log

[3526] private static org.apache.log4j.Logger log

[3527] For logging purposes.

[3528] 1.2.8.2 type

[3529] private java.lang.String type

[3530] The name of the ItemType to filter on.

[3531] 1.2.8.3 included

[3532] private boolean included

[3533] Whether to include or exclude items of the type.

Constructor Detail

[3534] 1.2.8.4 ItemItemTypeFilter

[3535] public ItemItemTypeFilter ( )

Method Detail

[3536] 1.2.8.5 getItemType

[3537] public java.lang.String getItemType ( )

[3538] Provides the ItemType that is being used by the filter.

[3539] Returns:

[3540] the item type being used by the filter

[3541] 1.2.8.6 setItemType

[3542] public void setItemType(java.lang.String type)

[3543] Sets the ItemType to be used by the filter.

[3544] Parameters:

[3545] type—the item type to be used by the filter

[3546] 1.2.8.7 isIncluded

[3547] public boolean isIncluded ( )

[3548] Indicates whether the filter will include or exclude items ofthle specified type.

[3549] Returns:

[3550] true if items will be included, false otherwise

[3551] 1.2.8.8 setIncluded

[3552] public void setIncluded(boolean included)

[3553] Sets whether the filter will include or exclude items of thespecified type. Defaults to true.

[3554] Parameters:

[3555] included—true if the items will be included, false otherwise

[3556] 1.2.8.9 filter

[3557] public boolean filter(java.lang.Object obj)

[3558] Indicates whether an Object passes this filter.

[3559] Parameters:

[3560] obj—the object to pass through the filter.

[3561] Returns:

[3562] true if the object passes, false otherwise

1.2.9 CLASS ITEMLASTMODIFICATIONDATECOMPARATOR

[3563]

[3564] All Implemented Interfaces:

[3565] java.util.Comparator

[3566] public class ItemLastModificationDateComparator

[3567] extends java.lang.Object

[3568] implements java.util.Comparator

[3569] Comparator that is able to compare an Item's last modificationdate to a Date. Field Summary private log static org.apache.log4j.LoggerFor logging purposes.

Constructor Summary

[3570]ItemLastModificationDateComparator ( ) Method Summary intcompare(java.lang.Object o1, java.lang.Object o2) Compares two objects,which may be ItemS or DateS.

[3571] Methods inherited from class java.lang.Object

[3572] clone, equals, finalize, getClass, hashCode, notify, notifyAll,toString, wait, wait, wait

[3573] Methods inherited from interface java.util.Comparator

[3574] equals

Field Detail

[3575] 1.2.9.1 log

[3576] private static org.apache.log4j.Logger log

[3577] For logging purposes.

Constructor Detail

[3578] 1.2.9.2 ItemLastModificationDateComparator

[3579] public ItemLastModificationDateComparator ( )

Method Detail

[3580] 1.2.9.3 compare

[3581] public int compare(java.lang.Object o1, java.lang.Object o2)

[3582] throws java.lang.ClassCastException

[3583] Compares two objects, which may be Items or Dates.

[3584] Specified by:

[3585] compare in interface j ava.util Comparator

[3586] Parameters:

[3587] o1—the first object to compare

[3588] o2—the second object to compare

[3589] Returns:

[3590] a negative integer, zero, or a positive integer as the firstargument is less than, equal to, or greater than the second

[3591] Throws:

[3592] java. lang. ClasscastException—if the arguments' types preventthem from being compared by this Comparator

1.2.10 CLASS ITEMLASTMODIFICATIONDATEFILTER

[3593]

[3594] All Implemented Interfaces:

[3595] com.conceptis.util.filter.Filter

[3596] public class ItemLastModificationDateFilter

[3597] extends ItemDateRangeFilter

[3598] Filters a Collection of Items using the last modified date and arange of dates. Field Summary private comparator staticjava.util.Comparator The comparator to use.

[3599] Fields inherited from classcom.conceptis.cms.filter.ItemDateRangeFilter

[3600]DEFAULT PATTERN

[3601] Field inherited from class com.conceptis.util.filter.RangeFilter

Constructor Summary

[3602]ItemLastModificationDateFilter ( )

[3603] Creates a new filter.

[3604] Methods inherited from classcom.conceptis.cms.filter.ItemDateRangeFilter

[3605]getEndDate, getLocale, getPattern, getStartDate, parseLocale,setEndDate, setLocale, setPattern, setStartDate

[3606] Methods inherited from classcom.conceptis.util.filter.RangeFilter

[3607] Filter, getComparator, getEnd, getStart, isInclusive, isInside,setComparator, setEnd, setInclusive, setInside, setStart

[3608] Methods inherited from classcom.conceptis.util.filter.AbstractFilter

[3609] filter

[3610] Methods inherited from class java.lang.Object

[3611] clone, equals, finalize, getClass, hashCode, notify, notifyAll,toString, wait, wait, wait

Field Detail

[3612] 1.2.10.1 comparator

[3613] private static java.util.Comparator comparator

[3614] The comparator to use.

Constructor Detail

[3615] 1.2.10.2 ItemLastModificationDateFilter

[3616] public ItemLastModificationDateFilter ( )

[3617] Creates a new filter.

1.2.11 CLASS ITEMLASTMODIFICATIONUSERFILTER

[3618]

[3619] All Implemented Interfaces:

[3620] com.conceptis.util.filter.Filter

[3621] public class ItemLastModificationUserFilter

[3622] extends com.conceptis.util.filter.AbstractFilter

[3623] Filters a Collection of Items using the last user to modify(username). Field Summary private boolean included Whether to include orexclude items of the type. private log static org.apache.log4j.LoggerFor logging purposes. private java.lang.String username The username ofthe user to filter on.

Constructor Summary

[3624]ItemLastModificationUserFilter ( ) Method Summary booleanfilter(java.lang.Object obj) Indicates whether an Object passes thisfilter. java.lang.String getUsername( ) Provides the username that isbeing used by the filter. boolean isIncluded( ) Indicates whether thefilter will include or exclude items of the specified type. voidsetIncluded(boolean included) Sets whether the filter will include orexclude items of the specified type. void setUsername(java.lang.Stringusername) Sets the username to be used by the filter.

[3625] Methods inherited from classcom.conceptis.util.filter.AbstractFilter

[3626] filter

[3627] Methods inherited from class java.lang.Object

[3628] clone, equals, finalize, getClass, hashCode, notify, notifyAll,toString, wait, wait, wait

Field Detail

[3629] 1.2.11.1 log

[3630] private static org.apache.log4j.Logger log

[3631] For logging purposes.

[3632] 1.2.11.2 username

[3633] private java.lang.String username

[3634] The username of the user to filter on.

[3635] 1.2.11.3 included

[3636] private boolean included

[3637] Whether to include or exclude items of the type.

Constructor Detail

[3638] 1.2.11.4 ItemLastModificationUserFilter

[3639] public ItemLastModificationUserFilter ( )

[3640] 1.2.11.5 getUsername

[3641] public java.lang.String getUsername ( )

[3642] Provides the Username that is being used by the filter.

[3643] Returns:

[3644] the username being used by the filter

[3645] 1.2.11.6 setUsername

[3646] public void setUsername(java.lang.String username)

[3647] Sets the username to be used by the filter.

[3648] Parameters:

[3649] Username—the Username to be used by the filter

[3650] 1.2.11.7 isIncluded

[3651] public boolean isIncluded ( )

[3652] Indicates whether the filter will include or exclude items of thespecified type.

[3653] Returns:

[3654] true if items will be included, false otherwise

[3655] 1.2.11.8 setIncluded

[3656] public void setInclud d(boolean included)

[3657] Sets whether the filter will include or exclude items of thespecified type.

[3658] Parameters:

[3659] included—true if the items will be included, false otherwise

[3660] 1.2.11.9 filter

[3661] public boolean filter(java.lang.object obj)

[3662] Indicates whether an Object passes this filter.

[3663] Parameters:

[3664] obj—the object to pass through the filter.

[3665] Returns:

[3666] true if the object passes, false otherwise

1.2.12 CLASS ITEMNAMECOMPARATOR

[3667]

[3668] All Implemented Interfaces:

[3669] java.util.Comparator

[3670] public class ItemNameComparator

[3671] extends java.lang.Object

[3672] implements java.util.Comparator

[3673] Comparator that is able to compare an Item's names. Field Summaryprivate log static org.apache.log4j.Logger For logging purposes. privateboolean reverse Reverses the order.

Constructor Summary

[3674]ItemNameComparator ( )

[3675] Creates a comparator.

[3676]ItemNameComparator(boolean reverse)

[3677] Creates a comparator. Method Summary int compare(java.lang.Objecto1, java.lang.Object o2) Compares two objects, which may be Items orDates.

[3678] Methods inherited from class java.lang.Object

[3679] clone, equals, finalize, getClass, hashCode, notify, notifyAll,toString, wait, wait, wait

[3680] Methods inherited from interface java.util.Comparator

[3681] equals

Field Detail

[3682] 1.2.12.1 log

[3683] private static org.apache.log4j.Logger log

[3684] For logging purposes.

[3685] 1.2.12.2 reverse

[3686] private boolean reverse

[3687] Reverses the order.

Constructor Detail

[3688] 1.2.12.3 ItemNameComparator

[3689] public ItemNameComparator ( )

[3690] Creates a comparator.

[3691] 1.2.12.4 ItemNameComparator

[3692] public ItemNameComparator(boolean reverse)

[3693] Creates a comparator.

[3694] Parameters:

[3695] reverse—true if the order is to be reversed

Method Detail

[3696] 1.2.12.5 compare

[3697] public int compare(java.lang.Object o1, java.lang.Object o2)

[3698] throws java.lang.ClassCastException

[3699] Compares two objects, which may be Items or Dates.

[3700] Specified by:

[3701] compare in interface java.util.Comparator

[3702] Parameters:

[3703] o1—the first object to compare

[3704] o2—the second object to compare

[3705] Returns:

[3706] a negative integer, zero, or a positive integer as the firstargument is less than, equal to, or greater than the second

[3707] Throws:

[3708] java.lang.ClassCastException—if the arguments'types prevent themfrom being compared by thius Comparator

1.2.13 CLASS ITEMPUBLICATIONSTATUSFILTER

[3709]

[3710] All Implemented Interfaces:

[3711] com.conceptis.util.filter.Filter

[3712] public class ItemPublicationStatusFilter

[3713] extends com.conceptis.util.filter.AbstractFilter

[3714] Filters a Collection of Items using the PublicationStatus. FieldSummary private boolean included Whether to include or exclude items ofthe type. private log static org.apache.log4j.Logger For loggingpurposes. private java.lang.String status The name of thePublicationStatus to filter on.

Constructor Summary

[3715]ItemPublicationStatusFilter ( ) Method Summary booleanfilter(java.lang.Object obj) Indicates whether an Object passes thisfilter. java.lang.String getPublicationStatus( ) Provides thePublicationStatus that is being used by the filter. boolean isIncluded() Indicates whether the filter will include or exclude items of thespecified type. void setIncluded(boolean included) Sets whether thefilter will include or exclude items of the specified type. voidsetPublicationStatus (java.lang.String status) Sets thePublicationStatus to be used by the filter.

[3716] Methods inherited from classcom.conceptis.util.filter.AbstractFilter

[3717] filter

[3718] Methods inherited from class java.lang.Object

[3719] clone, equals, finalize, getClass, hashCode, notify, notifyAll,toString, wait, wait, wait

Field Detail

[3720] 1.2.13.1 log

[3721] private static org.apache.log4j.Logger log

[3722] For logging purposes.

[3723] 1.2.13.2 status

[3724] private java.lang.String status

[3725] The name of the PublicationStatus to filter on.

[3726] 1.2.13.3 included

[3727] private boolean included

[3728] Whether to include or exclude items of the type.

[3729] Constructor Detail

[3730] 1.2.13.4 ItemPublicationStatusFilter

[3731] public ItemPublicationStatusFilter ( )

Method Detail

[3732] 1.2.13.5 getPublicabonStatus

[3733] public java.lang.String getPublicationStatus ( )

[3734] Provides the PublicationStatus that is being used by the filter.

[3735] Returns:

[3736] the status being used by the filter

[3737] 1.2.13.6 setPublicationStatus public voidsetPublicationStatus(java.lang.String status)

[3738] Sets the PublicationStatus to be used by the filter.

[3739] Parameters:

[3740] status—the item status to be used by the filter

[3741] 1.2.13.7 isIncluded

[3742] public boolean isIncluded ( )

[3743] Indicates whether the filter will include or exclude items of thespecified type.

[3744] Returns:

[3745] true if items will be included, false otherwise

[3746] 1.2.13.8 setIncluded

[3747] public void setIncluded(boolean included)

[3748] Sets whether the filter will include or exclude items of thespecified type.

[3749] Parameters:

[3750] included—true if the items will be included, false otherwise

[3751] 1.2.13.9 filter

[3752] public boolean filter(java.lang.object obj)

[3753] Indicates whether an Object passes this filter.

[3754] Parameters:

[3755] obj—the object to pass through the filter.

[3756] Returns:

[3757] true if the object passes, false otherwise

1.2.14 CLASS OBJECTWITHPRIMARYKEYCOMPARATOR

[3758]

[3759] All Implemented Interfaces:

[3760] java.util.Comparator

[3761] public class ObjectWithPrimaryKeyComparator

[3762] extends java.lang.Object

[3763] implements java.util.Comparator

[3764] Comparator that utilizes an object's PrimaryKey to sort acollection. Field Summary private boolean ascending Whether to sortascending or descending. private log static org.apache.log4j.Logger Forlogging purposes.

Constructor Summary

[3765]ObjectWithPrimaryKeyComparator ( ) Method Summary intcompare(java.lang.Object o1, java.lang.Object o2) Compares its twoarguments for order. boolean isAscending( ) Indicates whether thecomparator is sorting in an ascending or descending manner. voidsetAscending (boolean ascending) Sets whether the comparator is sortingin an ascending or descending manner.

[3766] Methods inherited from class java.lang.Object

[3767] clone, equals, finalize, getClass, hashCode, notify, notifyAll,toString, wait, wait, wait

[3768] Methods inherited from interface java.util.Comparator

[3769] equals

Field Detail

[3770] 1.2.14.1 log

[3771] private static org.apache.log4j.Logger log

[3772] For logging purposes.

[3773] 1.2.14.2 ascending

[3774] private boolean ascending

[3775] Whether to sort ascending or descending.

Constructor Detail

[3776] 1.2.14.3 ObjectWithPrimaryKeyCompartor

[3777] public ObjectwithPrimaryKeyComparator ( )

Method Detail

[3778] 1.2.14.4 isAscending

[3779] public boolean isAscending ( )

[3780] Indicates whether the comparator is sorting in an ascending ordescending manner.

[3781] Returns:

[3782] true if the comparator is ascending, false if descending

[3783] 1.2.14.5 setAscending

[3784] public void setAscending(boolean ascending)

[3785] Sets whether the comparator is sorting in an ascending ordescending manner.

[3786] Parameters:

[3787] ascending—true if the comparator is ascending, false otherwise

[3788] 1.2.14.6 compare

[3789] public int compare(java.lang.Object o1, java.lang.Object o2)

[3790] throws java.lang.ClassCastException

[3791] Compares its two arguments for order. Returns a negative integer,zero, or a positive integer as the first argument is less than, equalto, or greater than the second.

[3792] Specified by:

[3793] compare in interface java.util.Comparator

[3794] Parameters:

[3795] o1—the first object to be compared

[3796] o2—the second object to be compared

[3797] Returns:

[3798] a negative integer, zero, or a positive integer as the firstargument is less than, equal to, or greater than the second

[3799] Throws:

[3800] java.lang.ClassCastException—if the arguments' types prevent themfrom being compared by this Comparator cl 1.3 PACKAGECOM.CONCEPTIS.CMS.UTIL

1.3.1 CLASS CMSMANAGERFACTORY

[3801]

[3802] public class CmsManagerFactory

[3803] extends java.lang.Object

[3804] This class is used to get a CmsManager

[3805] See Also:

[3806]CmsServer

Constructor Summary

[3807]CmsManagerFactory ( ) Method Summary CmsManager getCmsManager( )get a CmsManager

[3808] Methods inherited from class java.lang.Object

[3809] clone, equals, finalize, getClass, hashCode, notify, notifyAll,toString, wait, wait, wait

Constructor Detail

[3810] 1.3.1.1 CmsManagerFactory

[3811] public CmsManagerFactory ( )

Method Detail

[3812] 1.3.1.2 getCmsManager

[3813] public CmsManager getCmsManager ( )

[3814] get a CmsManager

[3815] Returns:

[3816] CmsManager

1.3.2 CLASS CMSSERVER

[3817]

[3818] Direct Known Subclasses:

[3819]PoolingCmsServer, PseudoPoolingCmsServer

[3820] public class CmsServer

[3821] extends java.lang.Object

[3822] A CmsServer represents a CMS server and provides a useful singlepoint of entry to get and return Connections. Field Summary privateDriver driver The Driver to use for this CmsServer. privatejava.lang.String id The unique ID of this CmsServer private log staticorg.apache.log4j.Logger the log private java.util.Properties propertiesConfiguration options for the ConnectionS private java.util.HashMaproleMapping A HashMap of roles (String key) associated with a username/password pair (value stored in another HashMap, with ‘username’ and‘password’ keys). private java.lang.String url The URL that will be usedto get a Connection to the CmsServer.

Constructor Summary

[3823]CmsServer(java.lang.String id, java.lang.String driverClassName,java.lang.String url, java.util.HashMap roleMapping,java.util.Properties properties)

[3824] Creates a new CmsServer that will create Connections using thegiven URL and properties. Method Summary (package private)getConnection(java.lang.String role) Connection Returns a Connection tothis CmsServer, using the specified driver, url and properties. DrivergetDriver( ) Returns the Driver used by this CmsServer to establishConnection to the CMS. java.lang.String getId( ) Returns the unique IDassociated to this CmsServer. java.util.Properties getProperties( )Return the Properties used by this CmsServer to establish ConnectionS tothe CMS. java.util.Properties getProperties(java.lang.String role)Return the Properties used by this CmsServer to establish ConnectionS tothe CMS and using the specified role. java.util.HashMap getRoleMapping() Returns the HashMap of roles (String key) associated with ausername/password pair (value stored in a Properties class, with‘username’ and ‘password’ keys). java.lang.String getUrl( ) Returns theURL used by this CmsServer to establish Connection to the CMS. (packageprivate) returnConnection(Connection connection) void Returns the givenConnection to this CmsServer, that will dispose of it. java.lang.StringtoString( ) Returns a String representation of this CmsServer.

[3825] Methods inherited from class java.lang.Object

[3826] clone, equals, finalize, getClass, hashCode, notify, notifyAll,wait, wait, wait

Field Detail

[3827] 1.3.2.1 log

[3828] private static org.apache.log4j.Logger log

[3829] the log

[3830] 1.3.2.2 id

[3831] private java.lang.String id

[3832] The unique ID of this CmsServer

[3833] 1.3.2.3 driver

[3834] private Driver driver

[3835] The Driver to use for this CmsServer.

[3836] 1.3.2.4 url

[3837] private java.lang.String url

[3838] The URL that will be used to get a Connection to the CmsServer.

[3839] 1.3.2.5 roleMapping

[3840] private java.util.HashMap role Mapping

[3841] A HashMap of roles (String key) associated with ausername/password pair (value stored in another HashMap, with ‘username’and ‘password’ keys).

[3842] 1.3.2.6 properties

[3843] private java.util.Properties properties

[3844] Configuration options for the Connections

Constructor Detail

[3845] 1.3.2.7 CmsServer

[3846] public CmsServer(java.lang.String id, java.lang.StringdriverClassName, java.lang.String url, java.util.HashMap roleMapping,java.util.Properties properties)

[3847] throws java.lang.IllegalArgumentException

[3848] Creates a new CmsServer that will create Connections using thegiven URL and properties.

[3849] Parameters:

[3850] id—the unique ID of this CmsServer

[3851] driverClassName—the fully qualifed name of the Driver

[3852] url—the url to open a connection to

[3853] roleMapping—a HashMap of roles (String key) associated with ausername/password

[3854] pair (value stored in a Properties class)

[3855] properties—configuration options for the desired connection

[3856] Throws:

[3857] java. lang. IllegalArgumentException—if one of the parameters isnot valid

Method Detail

[3858] 1.3.2.8 getConnection

[3859]Connection getConnection(java.lang.String role)

[3860] throws ConnectionException, AuthenticationException,AuthorizationException

[3861] Returns a Connection to this CmsServer, using the specifieddriver, url and properties.

[3862] Parameters:

[3863] role—the user role to create the Connection for

[3864] Returns:

[3865] a Connection to this CmsServer.

[3866] Throws:

[3867]ConnectionException—thrown if there is a problem

[3868]AuthenticationException—thrown if the username/passwordcombination is invalid

[3869]AuthorizationException—if the site is inaccessible

[3870] 1.3.2.9 returnConnection

[3871] void returnConnection(Connection connection)

[3872] Returns the given Connection to this CmsServer, that will disposeof it. The default implementation juste closes the Connection, loggingany Exception that may occur during this operation.

[3873] Parameters:

[3874] connection—the Connection to return to this CmsServer

[3875] 1.3.2.10 getld

[3876] public java.lang.String getId ( )

[3877] Returns the unique ID associated to this CmsServer.

[3878] Returns:

[3879] the unique ID associated to this CmsServer

[3880] 1.3.2.11 getDriver

[3881] public Driver getDriver ( )

[3882] Returns the Driver used by this CmsServer to establish Connectionto the CMS.

[3883] Returns:

[3884] the Driver used by this CmsServer

[3885] 1.3.2.12 getUrl

[3886] public java.lang.String getUrl ( )

[3887] Returns the URL used by this CmsServer to establish Connection tothe CMS.

[3888] Returns:

[3889] the URL used by this CmsServer

[3890] 1.3.2.13 getRoleMapping

[3891] public java.util.HashMap getRoleMapping ( )

[3892] Returns the HashMap of roles (String key) associated with ausername/password pair (value stored in a Properties class, with‘username’ and ‘password’ keys).

[3893] Returns:

[3894] the HashMap of roles

[3895] 1.3.2.14 getProperties

[3896] public java.util.Properties getproperties ( )

[3897] Return the Properties used by this CmsServer to establishConnections to the CMS.

[3898] Returns:

[3899] the Properties used by this CmsServer

[3900] 1.3.2.15 getProperties

[3901] public java.util.Properties getProperties(java.lang.String role)

[3902] throws java.lang.IllegalArgumentException

[3903] Return the Properties used by this CmsServer to establishConnections to the CMS and using the specified role.

[3904] Parameters:

[3905] role—the role for which the returned Properties are designed for

[3906] Returns:

[3907] the Properties used by this CmsServer and using the specifiedrole

[3908] Throws:

[3909] java. lang. IllegalArgumentException—if the specified role is notsupported

[3910] 1.3.2.16 toString

[3911] public java.lang.String toString ( )

[3912] Returns a String representation of this CmsServer.

[3913] Overrides:

[3914] toS.string in class java. lang.Object

[3915] Returns:

[3916] a String representation of this CmsServer

1.3.3 CLASS CONNECTIONPOOL

[3917]

[3918] All Implemented Interfaces:

[3919] com.codestudio.util.Pool,java.io.Serializable

[3920] public class ConnectionPool

[3921] extends com.codestudio.ufil.ObjectPool

[3922] A ConnectionPool is used by a PoolingcmsServer to poolConnections to a CMS.

[3923] See Also:

[3924] Serialized Form Field Summary private Driver driver The Driver touse to establish a private Connection log static org.apache.log4j.Loggerthe log private java.util.Properties properties the Properties to use toestablish a private java.lang.String Connection url the url to use toestablish a Connection

[3925] Fields inherited from class com.codestudio.util.ObjectPool

[3926] count, lifeguard, locked, logger, metadata, skimmer, unlocked

Constructor Summary

[3927]ConnectionPool (Driver driver, java.lang.String url,java.util.Properties properties, com.codestudio.util.PoolMetaDatapoolMetaData)

[3928] Creates a new CmsServer that will create Connections using thegiven URL and properties. Method Summary protected create( )java.lang.Object Creates a new Connection instance protected voidexpire(java.lang.Object obj) Closes the Connection. private voidsetDriver(Driver driver) Sets the Driver to use to establish aConnection private void setProperties(java.util.Properties properties)Sets the Properties to use to establish a Connection private voidsetUrl(java.lang.String url) Sets the url to use to establish aConnection java.lang.String toString( ) Returns a string representationof this ConnectionPool, which is mainly useful for debugging. protectedvalidate(java.lang.Object obj) boolean Validates a Connection.

[3929] Methods inherited from class com.codestudio.util.ObjectPool

[3930] checkIn, checkOut, checkTimeout, cleanUp, closeAllResources,debug, debug, debugMetrics, finalize, getPoolname, init, log, log,numCheckedInObjects, numCheckedOutobjects, numTotalobjects,requestobject, returnobject

[3931] Methods inherited from class java.lang.Object

[3932] clone, equals, getClass, hashCode, notify, notifyAll, wait, wait,wait

Field Detail

[3933] 1.3.3.1 log

[3934] private static org.apache.log4j.Logger log

[3935] 1.3.3.2 driver

[3936] private Driver driver

[3937] The Driver to use to establish a Connection

[3938] 1.3.3.3 url

[3939] private java.lang.String url

[3940] the url to use to establish a Connection

[3941] 1.3.3.4 properties

[3942] private java.util.Properties properties

[3943] the Properties to use to establish a Connection

Constructor Detail

[3944] 1.3.3.5 ConnectionPool

[3945] public ConnectionPool(Driver driver, java.lang.String url,java.util.Properties properties, com.codestudio.util.PoolMetaDatapoolMetaData)

[3946] throws java.lang.Exception

[3947] Creates a new CmsServer that will create Connections using thegiven URL and properties.

[3948] Parameters:

[3949] driver—the Driver to use to establich a Connection

[3950] url—the url to open a connection to

[3951] properties—configuration options for the desired connection

[3952] poolMetaData—specific pooling configuration, encapsulated in aPoolMetaData object

[3953] Throws:

[3954] java.lang.Exception—if an error occurs while initalizong thispool

Method Detail

[3955] 1.3.3.6 create

[3956] protected java.lang.Object create ( )

[3957] throws java.lang.Exception

[3958] Creates a new Connection instance

[3959] Specified by:

[3960] create in class com.codestudio.util.ObjectPool

[3961] Returns:

[3962] a new Connection

[3963] Throws:

[3964] java.lang.Exception—if the Connection creation encounters aproblem

[3965] 1.3.3.7 expire

[3966] protected void expire(java.lang.object obj)

[3967] Closes the Connection.

[3968] Overrides:

[3969] expire in class com. codestudio.util.ObjectPool

[3970] Parameters:

[3971] obj—the pooled object to kill

[3972] 1.3.3.8 validate

[3973] protected boolean validate(java.lang.Object obj)

[3974] Validates a Connection.

[3975] Specified by:

[3976] validate in class com.codestudio.util.ObjectPool

[3977] Parameters:

[3978] obj—the Connection to validate

[3979] Returns:

[3980] true if the Connection is valid; false otherwise

[3981] 1.3.3.9 setDriver

[3982] private void setDriver(Driver driver)

[3983] Sets the Driver to use to establish a Connection

[3984] Parameters:

[3985] driver—the Driver to use to establish a Connection

[3986] 1.3.3.10 setUrl

[3987] private void setUrl(java.lang.String url)

[3988] Sets the url to use to establish a Connection

[3989] Parameters:

[3990] url—the url to use to establish a Connection

[3991] 1.3.3.11 setProperties

[3992] private void setProperties(java.util.Properties properties)

[3993] Sets the Properties to use to establish a Connection

[3994] Parameters:

[3995] properties—the Properties to use to establish a Connection

[3996] 1.3.3.12 toString

[3997] public java.lang.String toString ( )

[3998] Returns a string representation of this ConnectionPool, which ismainly useful for debugging.

[3999] Overrides:

[4000] toString in class java.lang.Object

[4001] Returns:

[4002] a string representation of this ConnectionPool

1.3.4 CLASS DEFAULTCMSMANAGERIMPL

[4003]

[4004] All Implemented Interfaces:

[4005]CmsManager

[4006] public class DefaultCmsManagerImpl

[4007] extends java.lang.Object

[4008] implements CmsManager

[4009] This class is a default CmsManager implementation. TODO:DESCRIBEROUTING LOGIC HERE (WHEN IT'S IMPLEMENTED) Field Summary privatejava.util.HashMap cmsServers This HashMap contains all the CMS serversdefined in the configuration file. private java.util.HashMap connectionsA HashMap of ConnectionS and CmsServerS, used to link a returnedConnection to its originating CmsServer. private CmsServerdefaultCmsServer The default CmsServer private java.util.HashMapitemTypeHandlers The associations between ItemTypeS and a specificCmsServer: the key is the ItemType name, and the value is the CmsServerthat will handle it. private log static org.apache.log4j.Logger the log

Constructor Summary

[4010]DefaultCmsManagerImpl ( ) Method Summary voidaddCmsServer(CmsServer cmsServer) Adds a CmsServer to the list ofavailable servers. private addItemTypeHandler(java.lang.StringitemTypeName, void CmsServer cmsServer) Adds a ItemType to the routinglogic, associated with the specified CmsServer. voidaddRoutingProperty(CmsServer cmsServer, java.lang.String propertyName,java.lang.String propertyValue) Adds a routing property to thisCmsManager for the specified CmsServer. CmsServergetCmsServer(java.lang.String id) Returns the CmsServer that has thespecified ID. private getConnection(CmsServer cmsServer,java.lang.String role) Connection get a connection with role ConnectiongetConnection(java.lang.String role) get a Connection with roleConnection getConnection(java.lang.String role, java.lang.StringitemTypeName) get a Connection with role and typeName voidreleaseConnection(Connection conn) release the Connection to theConnection Pool. private setDefaultCmsServer(CmsServer defaultCmsServer)void Sets the default CmsServer bor this CmsManager.

[4011] Methods inherited from class java.lang.Object

[4012] clone, equals, finalize, getClass, hashCode, notify, notifyAll,toString, wait, wait, wait

Field Detail

[4013] 1.3.4.1 log

[4014] private static org.apache.log4j.Logger log

[4015] the log

[4016] 1.3.5 CMSSERVERS

[4017] private java.util.HashMap cmsServers

[4018] This HashMap contains all the CMS servers defined in theconfiguration file. The key is the unique ID associated to theCmsServer.

[4019] 1.3.5.1 defaultCmsServer

[4020] private CmsServer defaultCmsServer

[4021] The default CmsServer

[4022] 1.3.5.2 connections

[4023] private java.util.HashMap connections

[4024] A HashMap of connections and CmsServers, used to link a returnedConnection to its originating CmsServer.

[4025] 1.3.5.3 itemTypeHandlers

[4026] private java.util.HashMap itemTypeHandlers

[4027] The associations between ItemTypes and a specific CmsServer: thekey is the ItemType name, and the value is the CmsServer that willhandle it.

Constructor Detail

[4028] 1.3.5.4 DefaultCmsManagerImpl

[4029] public DefaultCmsManagerImpl ( )

Method Detail

[4030] 1.3.5.5 addCmsServer

[4031] public void addCmsserver(CmsServer cmsServer)

[4032] Adds a CmsServer to the list of available servers.

[4033] Specified by:

[4034]addCmsServer in interface CmsManager

[4035] Parameters:

[4036] cmsServer—the CmsServer to add to the list of availableCmsServers for this CmsManager

[4037] 1.3.5.6 addRoutingProperty

[4038] public void addRoutingProperty(CmsServer cmsServer,java.lang.String propertyName, java.lang.String propertyvalue)

[4039] Adds a routing property to this CmsManager for the specifiedCmsServer.

[4040] Specified by:

[4041] addRoutingProperty in interface CmsManager

[4042] Parameters:

[4043] cmsServer—the CmsServer concerned by this routing rule

[4044] propertyName—the name of the property

[4045] propertyValue—the value of the property

[4046] 1.3.5.7 setDefaultCmsServer

[4047] private void setDefaultCmsServer(CmsServer defaultCmsServer)

[4048] Sets the default CmsServer bor this cmsManager.

[4049] Parameters:

[4050] defaultCmsServer—the default CmsServer for this cmsManager

[4051] 1.3.5.8 addItemTypeHandler

[4052] private void addItemTypeHandler(java.lang.String itemTypeName,CmsServer cmsServer)

[4053] Adds a ItemType to the routing logic, associated with thespecified CmsServer.

[4054] Parameters:

[4055] itemTypeName—the name the will be used to identify the ItemType

[4056] cmsServer—the CmsServer that will handle the specified ItemTypeidentified by the itemTypeName parameter

[4057] 1.3.5.9 getCmsServer

[4058] public CmsServer getCmsServer(java.lang.String id)

[4059] Returns the CmsServer that has the specified ID.

[4060] Specified by:

[4061]getCmsServer in interface CmsManager

[4062] Parameters:

[4063] id—ths unique ID of the CmsServer

[4064] Returns:

[4065] the cmsserver that has the specified ID; null if it doesn't exist

[4066] 1.3.5.10 getConnection

[4067] private Connection getConnection(CmsServer cmsServer,java.lang.String role)

[4068] throws CmsException

[4069] get a Connection with role

[4070] Parameters:

[4071] cmsServer—the CmsServer to use

[4072] role—the user role

[4073] Returns:

[4074] a Connection

[4075] Throws:

[4076]CmsException—in case of errors

[4077] 1.3.5.11 getConnection

[4078] public Connection getConnection(java.lang.String role)

[4079] throws CmsException

[4080] get a Connection with role

[4081] Specified by:

[4082]getconnection in interface CmsManager

[4083] Parameters:

[4084] role—the user role

[4085] Returns:

[4086] a Connection

[4087] Throws:

[4088]CmsException—in case of errors

[4089] 1.3.5.12 getConnection

[4090] public Connection getConnection(java.lang.String role,java.lang.String itemTypeName)

[4091] throws CmsException

[4092] get a Connection with role and typeName

[4093] Specified by:

[4094]getConnection in interface CmsManager

[4095] Parameters:

[4096] role—the user role

[4097] itemTypeName—the name of the item type

[4098] Returns:

[4099] a Connection

[4100] Throws:

[4101]CmsException—in case of errors

[4102] 1.3.5.13 releaseConnection

[4103] public void releaseconnection(Connection conn)

[4104] throws CmsException

[4105] release the Connection to the Connection Pool.

[4106] Specified by:

[4107] releaseConnection in interface CmsManager

[4108] Parameters:

[4109] conn—the Connection to release

[4110] Throws:

[4111]CmsException—in case of errors

1.3.6 CLASS NODEDATA

[4112]

[4113] All Implemented Interfaces:

[4114] java.io.Serializable

[4115] public class NodeData

[4116] extends java.lang.Object

[4117] implements java.io.Serializable

[4118] This class represents an item in the CMS as a serializableobject. It is made to be extended, containing only the primary key ofthe node.

[4119] See Also:

[4120] Serialized Form Field Summary private id java.lang.String Theprimary key of the node.

Constructor Summary

[4121]NodeData ( ) Method Summary java.lang.String getId( ) Provides theid of the node. void setId(java.lang.String id) Sets the id of the node.java.lang.String toString( ) Provides a string representation of theobject.

[4122] Methods inherited from class java.lang.Object

[4123] clone, equals, finalize, getClass, hashCode, notify, notifyAll,wait, wait, wait

Field Detail

[4124] 1.3.6.1 id

[4125] private java.lang.String id

[4126] The primary key of the node.

Constructor Detail

[4127] 1.3.6.2 NodeData

[4128] public NodeData ( )

Method Detail

[4129] 1.3.6.3 getld

[4130]10 public java.lang.String getId ( )

[4131] Provides the id of the node.

[4132] Returns:

[4133] the id of the node

[4134] 1.3.6.4 setId

[4135] public void setId(java.lang.string id)

[4136] Sets the id of the node.

[4137] Parameters:

[4138] id—the id of the node

[4139] 1.3.6.5 toString

[4140] public java.lang.String toString ( )

[4141] Provides a string representation of the object.

[4142] Overrides:

[4143] toString in class java.lang.Object

[4144] Returns:

[4145] a string representation of the object

1.3.7 CLASS NODELOADER

[4146]

[4147] public abstract class NodeLoader

[4148] extends java.lang.Object

[4149] Generates a serializable representation of a node in the CMS.Field Summary private org.apache.log4j.Logger log Used to log. privateroot javax.swing.tree.DefaultMutableTreeNode The root node where weappend children.

Constructor Summary

[4150]NodeLoader(javax.swing.tree.DefaultMutableTreeNode root)

[4151] Constructs a new NodeLoader. Method Summary voidappendChildNode(javax.swing.tree.Default MutableTreeNode root) Appendthe child node to the parent (root). abstract NodeDatagenerateNodeData(Item item, Connection conn) Generates a NodeData objectusing the values of the specified item. abstract java.util.SetgetChildren(Item item, Connection conn) Provides the Set of children forthe node. javax.swing.tree.DefaultMutableTreeNode getRoot( ) Providesthe root where we append children. abstract boolean isExpandable(Itemparent, Item child, Connection conn) Indicates whether a given node isexpandable. abstract boolean isInsertable(Item parent, Item child,Connection conn) Indicates whether a given node is insertable into thetree. void loadNode( ) load the node private void recurseChild(Itemitem, javax.swing.tree.DefaultMutableTreeNode parent, Connection conn)recurse over child item and create a new node.

[4152] Methods inherited from class java.lang.Object

[4153] clone, equals, finalize, getClass, hashCode, notify, notifyAll,toString, wait, wait, wait

Field Detail

[4154] 1.3.7.1 log

[4155] private org.apache.log4j.Logger log

[4156] Used to log.

[4157] 1.3.7.2 root

[4158] private javax.swing.tree.DefaultMutableTreeNode root

[4159] The root node where we append children.

Constructor Detail

[4160] 1.3.7.3 NodeLoader

[4161] public NodeLoader(javax.swing.tree.DefaultMutableTreeNode root)

[4162] Constructs a new NodeLoader.

[4163] Parameters:

[4164] root—the root node to append to

Method Detail

[4165] 1.3.7.4 getRoot

[4166] public javax.swing.tree.DefaultMutableTreeNode getRoot ( )

[4167] Provides the root where we append children.

[4168] Returns:

[4169] the root where we append children

[4170] 1.3.7.5 generateNodeData

[4171] public abstract NodeData generateNodeData(Itemitem, Connectionconn)

[4172] Generates a NodeData object using the values of the specifieditem.

[4173] Parameters:

[4174] item—the item to generate a data object for

[4175] conn—the connection, to interact with the CMS

[4176] Returns:

[4177] a data object for the specified item

[4178] 1.3.7.6 isExpandable

[4179] public abstract boolean isExpandable(Item parent, Item child,Connection conn)

[4180] Indicates whether a given node is expandable.

[4181] Parameters:

[4182] parent—the parent item to determine whether it's node isinsertable

[4183] child—the child item to determine whether it's node is insertable

[4184] conn—the connection, to interact with the CMS

[4185] Returns:

[4186] true if the node is expandable, false otherwise

[4187] 1.3.7.7 isinsertable

[4188] public abstract boolean isInsertable(Item parent, Item child,Connection conn)

[4189] Indicates whether a given node is insertable into the tree.

[4190] Parameters:

[4191] parent—the parent item to determine whether it's node isinsertable

[4192] child—the child item to determine whether it's node is insertable

[4193] conn—the connection, to interact with the CMS

[4194] Returns:

[4195] true if the node is insertable, false otherwise

[4196] 1.3.7.8 getchildren

[4197] public abstract java.util.Set getChildren(Itemitem, Connectionconn)

[4198] Provides the Set of children for the node.

[4199] Parameters:

[4200] item—the parent item

[4201] conn—the connection, to interact with the CMS

[4202] Returns:

[4203] the set of children

[4204] 1.3.7.9 loadNode

[4205] public void loadnode ( )

[4206] load the node

[4207] 1.3.7.10 appendChildNode

[4208] public voidappendChildNode(javax.swing.tree.DefaultMutableTreeNode root)

[4209] Append the child node to the parent (root).

[4210] Parameters:

[4211] root—the node parent

[4212] 1.3.7.11 recurseChild

[4213] private void recurseChild(Item item,javax.swing.tree.DefaultMutableTreeNode parent, Connection conn)

[4214] throws CmsException

[4215] recurse over child item and create a new node.

[4216] Parameters:

[4217] item—the item to get child

[4218] parent—the Node parent to append to

[4219] conn—the Connection used to get the RelationTypeFactory

[4220] Throws:

[4221]CmsException—in case of errors

1.3.8 CLASS POOLINGCMSSERVER

[4222]

[4223] public class PoolingCmsServer

[4224] extends CmsServer

[4225] A CmsServer represents a CMS server and provides a useful singlepoint of entry to get and return Connections. Field Summary privatejava.util.HashMap connectionPools A HashMap of ConnectionPoolS, one foreach role. private java.util.HashMap connections A HashMap ofConnectionPool, associated with a Connection private log staticorg.apache.log4j.Logger the log private poolMetaDatacom.codestudio.util.PoolMetaData The PoolMetaData that will be used tocreate the ConnectionPoolS for each role.

[4226] Fields inherited from class com.conceptis.cms.util.CmsServer

Constructor Summary

[4227]PoolingCmsServer(java.lang.String id, java.lang.StringdriverClassName, java.lang.String url, java.util.HashMap roleMapping,java.util.Properties properties, com.codestudio.util.PoolMetaDatapoolMetaData)

[4228] Creates a new CmsServer that will create Connections using thegiven URL and properties. Method Summary ConnectiongetConnection(java.lang.String role) Returns a Connection to thisCmsServer, using the specified driver, url and properties. voidreturnConnection(Connection connection) Returns the given Connection tothis CmsServer, that will dispose of it. privategetPoolMetaData(com.codestudio.util.PoolMetaData void pool MetaData)Sets the PoolMetaData used by this PoolingCmsServer.

[4229] Methods inherited from class com.conceptis.cms.util.CmsServer

[4230]getDriver, getId, getProperties, getProperties, getRoleMapping,getUrl, toString

[4231] Methods inherited from class java.lang.Object

[4232] clone, equals, finalize, getClass, hashCode, notify, notifyAll,wait, wait, wait

Field Detail

[4233] 1.3.8.1 log

[4234] private static org.apache.log4j.Logger log

[4235] the log

[4236] 1.3.8.2 connectionPools

[4237] private java.util.HashMap connectionPools

[4238] A HashMap of Connectionpools, one for each role.

[4239] 1.3.8.3 connections

[4240] private java.util.HashMap connections

[4241] A HashMap of ConnectionPool, associated with a Connection

[4242] 1.3.8.4 poolMetaData

[4243] private com.codestudio.util.PoolMetaData poolMetaData

[4244] The PoolMetaData that will be used to create the ConnectionPoolsfor each role.

Constructor Detail

[4245] 1.3.8.5 PoolingCmsServer

[4246] public PoolingCmsServer(java.lang.String id, java.lang.StringdriverClassName, java.lang.String url, java.util.HashMap roleMapping,java.util.Properties properties, com.codestudio.util.PoolMetaDatapoolMetaData)

[4247] throws java.lang.IllegalArgumentException

[4248] Creates a new CmsServer that will create Connections using thegiven URL and properties.

[4249] Parameters:

[4250] id—the unique ID of this CmsServer

[4251] driverClassName—the fully qualifed name of the Driver

[4252] url—the url to open a connection to

[4253] roleMapping—a HashMap of roles (String key) associated with aUsername/password

[4254] pair (value stored in a Properties class)

[4255] properties—configuration options for the desired connection

[4256] poolMetaData—the PoolMetaData that will be used to create theinternal

[4257] ConnectionPool

[4258] Throws:

[4259] java.lang.IllegalArgumentException—if one of the parameters isnot valid

Method Detail

[4260] 1.3.8.6 getconnection

[4261] public Connection getConnection(java.lang.String role)

[4262] throws ConnectionException, AuthenticationException,AuthorizationException

[4263] Returns a Connection to this CmsServer, using the specifieddriver, url and properties.

[4264] Overrides:

[4265]getConnection in class CmsServer

[4266] Parameters:

[4267] role—the user role to create the Connection for

[4268] Returns:

[4269] a Connection to this CmsServer.

[4270] Throws:

[4271]ConnectionException—thrown if there is a problem

[4272]AuthenticationException—thrown if the username/passwordcombination is invalid

[4273]AuthorizationException—if the site is inaccessible

[4274] 1.3.8.7 returnConnection

[4275] public void returnConnection(Connection connection)

[4276] Returns the given Connection to this CmsServer, that will disposeof it. The default implementation juste closes the Connection, loggingany Exception that may occur during this operation.

[4277] Overrides:

[4278] returnConnection in class CmsServer

[4279] Parameters:

[4280] connection—the Connection to return to this CmsServer

[4281] 1.3.8.8 setPoolMetaData

[4282] private void setPoolMetaData(com.codestudio.util.PoolMetaDatapoolMetaData)

[4283] Sets the PoolMetaData used by this PoolingCmsServer.

[4284] Parameters:

[4285] poolMetaData—the PoolMetaData used by this PoolingCmsServer

1.3.9 CLASS PSEUDOPOOLINGCMSSERVER

[4286]

[4287] public class PseudoPoolingCmsServer

[4288] extends CmsServer

[4289] A PseudoPoolingCmsServer represents a CMS server that creates andreturn only a single Connection for each username/password combination,and returns the same one to multiple processes at the same time. FieldSummary private java.util.HashMap connections A HashMap of ConnectionS,one for each role. private log static org.apache.log4j.Logger the log

[4290] Fields inherited from class com.concepti.cms.util.CmsServer

Constructor Summary

[4291]PseudoPoolingCmsServer(java.lang.String id, java.lang.StringdriverClassName, java.lang.String url, java.util.HashMap roleMapping,java.util.Properties properties)

[4292] Creates a new CmsServer that will create Connections using thegiven URL and properties. Method Summary ConnectiongetConnection(java.lang.String role) Returns a Connection to thisCmsServer, using the specified driver, url and properties. voidreturnConnection(Connection connection) Returns the given Connection tothis CmsServer, that will dispose of it.

[4293] Methods inherited from class com.conceptis.cms.util.CmsServer

[4294]getDriver, getId, getproperties, getProperties, getRoleMapping,getUrl, toString

[4295] Methods inherited from class java.lang.Object

[4296] clone, equals, finalize. qetClass, hashCode, notify, notifyAll,wait, wait, wait

Field Detail

[4297] 1.3.9.1 log

[4298] private static org.apache.log4j.Logger log

[4299] the log

[4300] 1.3.9.2 connections

[4301] private java.util.HashMap connections

[4302] A HashMap of Connections, one for each role.

Constructor Detail

[4303] 1.3.9.3 PseudoPoolingCmsServer

[4304] public PseudoPoolingCmsServer(java.lang.String id,java.lang.String driverClassName, java.lang.String url,java.util.HashMap roleMapping, java.util.Properties properties)

[4305] throws java.lang.IllegalArgumentException

[4306] Creates a new CmsServer that will create Connections using thegiven URL and properties.

[4307] Parameters:

[4308] id—the unique ID of this CmsServer

[4309] driverClassName—the fully qualifed name of the Driver

[4310] url—the url to open a connection to

[4311] roleMapping—a HashMap of roles (String key) associated with aUsername/password

[4312] pair (value stored in a Properties class)

[4313] properties—configuration options for the desired connection

[4314] Throws:

[4315] java.lang.IllegalArgumentException—if one of the parameters isnot valid

Method Detail

[4316] 1.3.9.4 getConnection

[4317] public ConnectiongetConnection(java.lang.String role)

[4318] throws ConnectionException, AuthenticationException,AuthorizationException

[4319] Returns a Connection to this CmsServer, using the specifieddriver, url and properties.

[4320] Overrides:

[4321] getconnection in class CmsServer

[4322] Parameters:

[4323] role—the user role to create the Connection for

[4324] Returns:

[4325] a Connection to this CmsServer,

[4326] Throws:

[4327]ConnectionException—thrown if there is a problem

[4328]AuthenticationException—thrown if the username/passwordcombination is invalid

[4329]AuthorizationException—if the site is inaccessible

[4330] 1.3.9.5 returnConnection

[4331] public void returnConnection(Connection connection)

[4332] Returns the given Connection to this CmsServer, that will disposeof it. The default implementation juste closes the Connection, loggingany Exception that may occur during this operation.

[4333] Overrides:

[4334]returnConnection in class CmsServer

[4335] Parameters:

[4336] connection—the Connection to return to this CmsServer

1.3.10 INTERFACE CMSMANAGER

[4337] All Known Implementing Classes:

[4338]DefaultCmsManagerImpl

[4339] public interface CmsManager

[4340] This interface is used to get a Connection to the cms.

[4341] See Also:

[4342]Connection Method Summary void addCmsServer(CmsServer cmsServer)Adds a CmsServer to the list of available servers. voidaddRoutingProperty(CmsServer cmsServer, java.lang.String propertyName,java.lang.String propertyValue) Adds a routing property to thisCmsManager for the specified CmsServer. CmsServergetcmsServer(java.lang.String id) Returns the CmsServer that has thespecified ID. Connection getConnection(java.lang.String role) get aConnection with role Connection getConnection(java.lang.String role,java.lang.String itemtypeName) get a Connection with role and typeNamevoid releaseConnection (Connection conn) release the Connection to theConnection Pool.

Method Detail

[4343] 1.3.10.1 addCmsServer

[4344] public void addCmsserver(CmsServer cmsServer)

[4345] Adds a CmsServer to the list of available servers.

[4346] Parameters:

[4347] cmsServer—the CmsServer to add to the list of availablecmsservers for this

[4348] CmsManager

[4349] 1.3.10.2 getCmsServer

[4350] public CmsServer getCmsServer(java.lang.String id)

[4351] Returns the CmsServer that has the specified ID.

[4352] Parameters:

[4353] id—ths unique ID of the CmsServer

[4354] Returns:

[4355] the CmsServer that has the specified ID; null if it doesn't exist

[4356] 1.3.10.3 addRoutingProperty

[4357] public void addRoutingProperty(CmsServer cmsServer,java.lang.String propertyName, java.lang.String propertyValue)

[4358] Adds a routing property to this CmsManager for the specifiedCmsServer.

[4359] Parameters:

[4360] cmsserver—the CmsServer concerned by this routing rule

[4361] propertyName—the name of the property

[4362] propertyValue—the value of the property

[4363] 1.3.10.4 getconnection

[4364] public Connection getConnection(java.lang.String role)

[4365] throws CmsException

[4366] get a Connection with role

[4367] Parameters:

[4368] role—the user role

[4369] Returns:

[4370] a Connection

[4371] Throws:

[4372]CmsException—in case of errors

[4373] 1.3.10.5 getconnection

[4374] public Connection getConnection(java.lang.String role,java.lang.String itemtypeName)

[4375] throws CmsException

[4376] get a Connection with role and typeName

[4377] Parameters:

[4378] role—the user role

[4379] itemtypeName—the name of the item type

[4380] Returns:

[4381] a Connection

[4382] Throws:

[4383]CmsException—in case of errors

[4384] 1.3.10.6 releaseConnection

[4385] public void releaseConnection(Connection conn)

[4386] throws CmsException

[4387] release the Connection to the Connection Pool.

[4388] Parameters:

[4389] conn—the Connection to release

[4390] Throws:

[4391]CmsException—in case of errors

[4392] The following example illustrates how the ItemFactory, Item,ItemType objects interact together in the context of a web application.

[4393] For example, a business process requires access to news articlespublished on a given date. The business process makes a content requestfor Items of ItemType “News” from the CMS. The business process isinterested in the fields: “Author”, “Data published”, “Title”, and“Body” in order to create a list of available news articles. The“getNews” business process resides as a Java class running as part of aJava based Web server. The application server (or web server) is firstinitialized and the CMS Manager object (com.conceptis.cms.util.DefaultCmsManagerlmpl) is instantiated. Each driver is assigned to theCMS Server object and is registered with the CMS Manager. For example,the business process “getNews” is invoked by the web server to retrievea piece of content. The business process first makes a request to theCMS Manager object to get a connection to a CMS. Once the businessprocess has a Connection object, the business process asks theConnection object for an ItemFactory object by invokingConnection.getItemFactory. The business process can now instruct theItemFactory to retrieve a piece of content, either by specifying the“Primary key” of the Item or other search criteria. The business process“getNews” creates an ItemSearchConstraints object and set the ItemTypeto “News” by invoking, constraints.addItemType(Connection.getItemTypeFactory ( ). getitemType(“News”)) and the Dateconstraints to the desired dates. The m ethod ItemFactory.searcho isinvoked by passing the search constraints object returning a List ofItems that match the search. The business process “getNews” can nowiterate through the returned list extracting the Items FieId data asdesired, e.g. to retrieve a given Items “Title” field, “getNews” wouldfirst get the Field object for the given ItemType usingItemType.getField(“Title”). Then, “getNews” could invokeItem.getFieldValue(Field) and be able to use the field data according toits field type (i.e. String, Date, integer, etc . . . )

[4394] The web-server, where one or more business processes (BP's) orservices reside, is responsible for instantiating the CMS Managerobject, which will manage any connections that the BP may require withthe external CMS. The web-server then, for each previously identifiedCMS, creates a CMS Server object that gets registered with the CMSManager. The web-server must be aware, typically using a configurationfile, of the actual implementation class names for each CMS Server 2.The CMS Server 2, on creation, loads the actual CMS Driver Interface 4according to a parameter. The CMS Server 2 is then responsible forrelaying connection requests between the implementation class and anyBP.

[4395] In other words the Connection object is the applications mainentry point into the CMS. The Connection class implementation isresponsible for implementing the methods that will provide access to thecontent Items themselves. The methods that the Connection implementsinclude the following:

[4396] getItem Factory

[4397] getItemTypeFactory

[4398] getIndexFactory

[4399] getCmsUserFactory

[4400] The application gets the Connection object reference by callingDriverManager.getConnection method, which is able to locate the methodimplementation since the driver must have registered itself with the CMSManager class as part of the driver's initialization.

[4401] The application is now able to access content Items byreferencing the virtual or abstract instances of the Item class and itsFields. The application can query the Items to get information a-s towhat fields the Item contains, e.g. using Item.getItemType.getFields.The application can access the Field contents by then iterating throughthe returned list of Fields using Item.getFieldValue(Field).

[4402] The application can also interrogate the Item to determinewhether the Item is associated with other Items, in the case where theItem might be an article with one or more associated images. Theapplication queries the Item by invoking itsgetRelateditems(RelationType) method. To get a list of the Itemschildren the application invokes:Item.getRelatedItems(RelationType.CHILD). The application can furtherquery the returned Items.

[4403]FIG. 8 shows a sample deployment model of the system of thepresent invention.

[4404] While a preferred embodiment of this invention have beenillustrated in the accompanying drawings and described above, it will beevident to those skilled in the art that changes and modifications maybe made therein without departing from the essence of this invention.

1. A method for a business process hosted on an application server torequest content from at least one external content management systemindependently of the manner in which the content is stored, the methodcomprising the steps of: a. making a content request from the businessprocess to one of said at least one external content management ystemvia a content miaiageient system server managing the content requestfrom the business process to one of said at least one external contentmanagement system; b. transmitting the content request between one ofsaid at least one external content management system and the contentmanagement system server via a content management system driverinterface translating a piece of content corresponding to the contentrequest from one of said at least one external content management systeminto a specific object representation, the content management systemdriver interface being operatively associated with said at least oneexternal content management system; c. managing the content request fromthe business process to one of said at least one external contentmanagement system and keeping track of content available from one ofsaid at least one external content management system operativelyassociated with the corresponding content management system driverinterface via a content management system manager; and d. relaying thespecific object representation of the content from the contentmanagement system driver interface to the business process via thecontent management system server.
 2. A system for a business processhosted on an application server to request content from at least oneexternal content management system independently of the manner in whichthe content is stored, the system comprising: a content managementsystem server for managing a content request from the business processto the external content management system; a content management systemdriver interface operatively associated with said at least one externalcontent management system for transmitting the content request betweenone of said at least one external content management system and thecontent management system server, the content management system driverinterface translating a piece of content corresponding to the contentrequest from one of said at least one external content management systeminto a specific object representation; and a content management systemmanager for managing the content request from the business process toone of said at least one external content managlement system and keepingtrack of content avaiiabie from one of said at least one externalcontent management system operatively associated with one of thecorresponding content management system driver interface, the contentmanagement system server relaying the specific object representation ofthe content from the content management system driver interface to thebusiness process.
 3. The system according to claim 2, wherein thecontent request is a reference to an object model.
 4. The systemaccording to claim 2, wherein the content management system driverinterface has a set of methods for accessing the content of thecorresponding one of said at least one external content managementsystem, the content management system driver interface forwarding thecontent request from the content management system server to thecorresponding one of said at least one external content managementsystem.
 5. The system according to claim 2, wherein the contentmanagement system server, the content management system manager and thecontent management system driver interface are all class implemented. 6.The system according to claim 2, wherein the business processestablishes a connection with one of said at least one external contentmanagement system via the content management system manager, the contentmanagement system manager returning a connection status to the businessprocess.
 7. The system according to claim 2, wherein the contentmanagement system driver interface comprises at least one driver, saidat least one driver being operatively associated with one of said atleast one external content management system, the driver establishing aconnection to and communicating with the corresponding one of said atleast one external content management system using specific parameters.8. The system according to claim 7, wherein the content managementsystem manager determines which one of said at lea-st one driveroperatively associated with one of said at least one external contentmanagement system has access to a content referred to in the contentrequest.
 9. The system according to claim 7, wherein the contentmanagement system manager comprises means for registering andunregistering said at least one driver, the content management systemmanager providing a connection to one of said at least one externalcontent management system via a corresponding one of said registereddriver.
 10. The system according to claim 7, further comprising acontent management system security manager for controlling a n access tofunctionalities of said at least one driver.
 11. The system according toclaim 10, wherein the specific parameters comprise an URL and a set ofcredentials, the content management system security manager controllingaccess to one of said at least one driver according to the set ofcredentials.